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PREFACE 


The CONTROL DATA® COMPASS Version 3-6 Assembler provides the user with a versatile, extensive 
language for generation of object code to be loaded and executed on the central processor unit (CPU) or a 
peripheral processor (PP or PPU), The assembler executes on the following computer systems and 
operating systems: 

I 

NOS 2 for the CDC CYBER 180 Computer Systems; CYBER 170 Computer Systems; CYBER 70 
Computer System models 71, 72, 73, and 74; and 6000 Computer Systems 

NOS/BE 1 for the CDC CYBER 180 Computer Systems; CYBER 170 Computer Systems; CYBER 70 
Computer System models 71, 72, 73, and 74; and 6000 Computer Systems 

SCOPE 2 for the CDC CYBER 170 Computer System model 176, CYBER 70 Computer System model 
76, and 7600 Computer Systems 

The CYBER 170 Computer Systems include the following 800 Series models: 815, 825, 835, 845, 855, 865, 
and 875- The CYBER 180 Computer Systems include the following 800 Series models: 810, 830, 835, 840, | 

845, 850, 855, 860, and 990. The CYBER 170 models 835, 845, and 855 are the same machines as the | 

CYBER 180 models 835, 845, and 855. References in the text to 800 Series models usually do not 
distinguish between CYBER 170 and CYBER 180. 

The CDC CYBER 170 Computer System models 720 and 730 have unified processors and use the 
instructions noted in this publication for computer models with a Compare/Move Unit (CMU) such as the 
CYBER 170 Computer System model 172. Models 810, 825, 830, 835, 845, 850, 855, and 860 also support | 
the com pare/move instructions through simulation. 

The CDC CYBER 170 Computer System models 740, 750, 760, 865, 875, and 990 have functional units and | 
use instructions noted in this publication for computer models with functional units such as the CYBER 170 
Computer System model 175. 

The reader is assumed to be familiar with a Control Data computer and operating system, and with 
assemblers in general. 


NOTE 

Avoid continued use of COMPASS in creating application programs when 
possible. COMPASS and other machine-dependent languages can complicate 
migration to future hardware and software systems. Software mobility wiU be 
restricted by continued use of COMPASS for stand-alone programs, COMPASS 
subroutines embedded in programs using higher-level languages, and COMPASS 
owncode routines used with CDC standard products. 

In this manual, the acronym ECS refers to all forms of extended memory unless otherwise noted, except in 
the context of a miiltimainframe environment or distributive data path (DDP) access, in which case, models 
176, 810, 815, 825, 830, 835, 840, 845, 850, 855, 860, 865, 875, and 990 are excluded. | 

Extended memory for the CYBER 170 Model 176, the CYBER 70 Model 76, and the 7600 is large central 
memory (LCM) or large central memory extended (LCMB). Extended memory for models 810, 815, 825, 

830, 835, 840, 845, 850, 855, 860, 865, 875, and 990 is unified extended memory (UEM). Extended memory | 
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for models 865 and 875 can also include extended core storage (ECS) or extended semiconductor memory 
(ESM). Extended memory for all other CYBER 170, CYBER 70, and 6000 Series Computer Systems is 
extended core storage (ECS) or extended semiconductor memory (ESM)* 

The CYBER 170 Model 176 supports direct LCM and LCME transfer instructions, as described in chapter 8. 
LCM and LCME transfers initiate an error exit, not a half exit, as noted in ECS/UEM Instructions, 
chapter 8. 

Hardware descriptions and further programming information for the various forms of extended memory can 
be found in the appropriate hardware reference manuals. 

In this manual, numbers occurring in text are decimal unless otherwise noted. Lowercase letters in formats 
depict variables. The examples assume that assembler numeric mode is decimal and that character mode is 
display code unless otherwise noted. In examples, statements generated by the assembler as a result of a 
caR or a substitution are shown in shaded print. 

General explanations of COMPASS concepts have been limited to the initial pages of each chapter or 
section, whenever possible. Subsequent material has been presented in a concise manner to aid in rapid 
access to reference information. In keeping with this concept, instruction indexes have been included 
inside the front and back covers. 

Additional information essential to programming in the COMPASS environment can be iomd in the 
publications listed in this preface. The publications are listed alphabetically within groupings that indicate 
their approximate importance to readers of this manual. Applicable operating systems are also indicated. 

The applications programmer will need the CYBER Record Manager Basic Access Methods and Advanced 
Access Methods manuals for information about the macros needed to define, access, and manipulate files. 
Information necessary to create and manipulate program structures can be found in the appropriate Loader 
reference manual (CYBER Loader for the NOS and NOS/BE operating systems, and the SCOPE 2 Loader for 
the SCOPE 2 operating system). 

In addition to the above, the systems programmer will need the appropriate operating system manual, 
either the NOS 1 Reference Manual or the NOS 2 Reference Set, Volume 4, Program Interface, to obtain 
information about system macros. 

The Software Publications Release History serves as a guide to the revision level of software 
documentation which corresponds to the Programming S^tem Report (PSR)levd of installed site software. 

The following manuals are of primary interest: 


Publication 

Publication 

Number 

NOS 2 

NOS/6 E 1 

SCOPE 2 

COMPASS Version 3 Instant 

60492800 

X 

X 

X 

CYBER Loader Version 1 
Reference Manual 

60429800 

X 



CYBER Record Manager 

Advanced Access Methods 

Version 2 Reference Manual 

50499300 

X 

X 


CYBER Record Manager 

Basie Access Methods 

Version 1.5 Reference Manual 

60495700 

X 

X 
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Publication 

Publication 

Number 

NOS 2 

NOS/BE 1 

SCOPE 2 

NOS Version 2 Reference Set, 

Volume 4 Program Interface 

60459690 

X 



NOS/BE 1 Reference Manual 

60493800 


X 


SCOPE 2 Loader Version 2 

Reference Manual 

60454780 



X 

SCOPE 2 Reference Manual 

60342600 



X 

following manuals are of secondary interest: 




Publication 

Publication 

Number 

NOS 2 

NOS/BE 1 

SCOPE 2 

CYBER Interactive Debug Version 1 
Reference Manual 

60481400 

X 

X 


Modify Version 1 Reference Manual 

60450100 


X 


NOS Version 2 Diagnostic Index 

60459390 

X 



NOS/BE Version 1 Diagnostic Index 

60456490 


X 


NOS Version 2 Manual Abstracts 

60485500 

X 



NOS/BE Version 1 Manual Abstracts 

84000470 


X 


Software Publications Release History 

60481000 

X 

X 

X 

Update Version 1 Reference Manual 

60449900 


X 

X 


CDC manuals can be ordered from Control Data Corporation, Literature and 
Distribution Services, 308 North Dale Street, St. Paul, Minnesota 55103, 


This product is intended for use only as described in this 
document. Control Data cannot be responsible for the proper 
functioning of undescribed features or parameters. 
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INTRODUCTION 


1 


This manual describes the features of the COMPASS V ersion 3 Eissembly language processor and the 
principles, methods, rules, and techniques of coding a COMPASS program. 

The user is assumed to be familiar with a Control Data computer and operating system, and is assumed to 
be familiar with assemblers in general. 

Readers with no previous experience with the COMPASS assembler are encouraged to direct their initial 
attention to the following sections of the manual: 


Chapter 1 

fiitroduction 

Chapter 2 

Language Structure 

Chapter 3 

Program Structure, sections 3.1 through 3.3 

Chapter 4 

Pseudo Instructions, sections 4.1 and 4.2 

Chapter 8 or 9 

CPU or PP Symbolic Machine Instructions, the chapter depending upon the 
machine language the user requires 

Chapter 10 

Program Execution 

Appendix D 

Hints on Using COMPASS (example program) 


COMPASS, like other assemblers, is machine- and operating system-dependent. The user, therefore, should 
be aware of restrictions imposed on COMPASS by the programming environment. Specifically, the user 
should note: 

Differences between CPU and PP program environments 

Features of COMPASS not supported by a particular operating system 

Machine and operating system limitations are outlined in the preface of this manual. The applicability of 
instruction sets is shown in the instruction indexes (inside front and back covers), and is addressed as 
necessary throughout the manual, 

A COMPASS program consists of one or more subprograms. From source language subprograms, the 
assembler generates binary output acceptable for loading and execution. The programmer can divide a 
subprogram, whether it is assembled as absolute or relocatable, into areas called blocks. Blocks are 
assembled independently. Thus, they can be loaded and executed independently or linked by the system 
loader preparatory to execution of the program. This capability provides much flexibility in combining, 
segmenting, overlaying, and ordering blocks for execution. 

Subprogram blocks consist of two types of source statements: 

Symbolic machine instructions 

Pseudo instructions 

Symbolic machine instructions are the counterparts of the binary machine instructions. They provide a 
means of expressing symbolically the data manipulation functions of the machine. Each symbolic 
instruction typically generates one machine instruction. 
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Pseudo instructions do not have a one-to-one relationship with binary machine instructions. They are used, 
instead, to control aspects of the assembly process, such as: 

Storage allocation 

Symbol definition 

Subprogram linkage 

Listing options 

Automatic generation of predefined code sequences (macros) 

From CPU source language subprograms, COMPASS generates absolute or relocatable binary output 
acceptable for loading and execution. From PPU source language subprograms, COMPASS generates 
absolute binary output to be loaded and executed on a peripheral processor unit. The operating system 
allows only specially privileged jobs to access a peripheral processor unit. 

/ 

Features inherent to COMPASS include: 

Free-field source Size of source statement fields is largely controlled by user, 

statement format 

Control of local Programmer and system can designate up to 255 areas to facilitate 

and common blocks interprogram communication. In CPU programs, common areas can be 

defined in small core memory (CM or SCM) or extended or large core 
memory (ECS or LCM). 

Preloaded data Data areas may be specified and loaded in core memory with the source 

program. 

Data notation Data can be designated in integer, floating-point, and character string 

notation. It can be introduced into the program as a data item, a constant, or 
a literal. 

Address arithmetic Addresses can be specified making extensive use of constants, symbolic 

addresses, and arithmetic expressions. 

Symbol equation and Equation and redefinition of symbols allow extensive parameterization 
redefinition of assembly and linkage of subprograms and subroutines. 

Symbol qualification Ability to associate a symbol qualifier with a symbol defined within a 

qualified sequence to render the symbol unique to the sequence. An 
unqualified symbol is global and can be referred to from within any sequence 
without qualification. 

Binary control The programmer can specify whether binary output is to be absolute or 

relocatable. Absolute code can be generated for any PPU or CPU. 

Relocatable code can be generated for any CPU. Binary can be written as 
overlays or as partial records. 

Selective assembly of Assembly-time tests allow the user to select or alter code sequences, 
code sequences 

Mode control Ability to specify the base to be used for numeric notation not explicitly 

defined as octal or decimal, and to specify the code conversion to be applied 
to character data as either display code, ASCII, internal BCD, or 
external BCD. 

( 
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Listing control Assembly-time control of list content. 

Micro coding Substitution of sequences of characters defined in the program wnenever the 

micro name is referenced. Several micros are predefined by the system for 
user convenience. 


Macro coding Assembly of sequences of instructions defined in the program or on the 

system library whenever the macro name is referenced. Macro definitions 
can be redefined or purged from the operation code table. 

Operation code table The programmer can specify or respecify the syntax of a CPU or PPU 

instruction. The assembler generates an entry in the operation code table for 
the instruction- No macro or opdef definition is associated with the entry. 


Operation code Assembly of sequences of instructions defined in the program or on the 

definition system library whenever an operation code of the specified syntax is 

referenced. 


Code repetition 
Remote assembly 
Library routine calls 
Diagnostics 


Sequences of code can be repeated during assembly or at load time. 
Defers assembly of defined coding sequence until later in the assembly. 
Routines can be called from the system library. 

Diagnostics for source program errors are included on output listing. 


1.1 CONFIGURATION 

The hardware requirements for executing COMPASS on a CPU are the minimum required for the operating 
system. 


1.2 ASSEMBLER EXECUTION 

COMPASS is called from the system library by a COMPASS control statement (chapter 10) or FORTRAN 
compiler upon encountering a COMPASS IDENT statement in the source input file. Parameters on the 
control statement specify files used during the assembler run such as the file containing source statements 
and the files to receive listable output and load-and-go output. The COMPASS assembler executes as a 
CPU program. 

The operating system aUoeates the input/output resources as needed and performs all input/output required 
during the assembly. 

COMPASS assembles each subprogram on the source file, in turn, in two passes. During the first pass, it 
reads each source language instruction, expands and edits called sequences as needed, interprets the 
operation code, and assigns storage. 

The function of the second pass is to assign block origins, locate literals, fill in all valid symbol values and 
produce the assembly listing and binary output. Finally, it prepares the symbolic reference table and 
reinitializes itself preparatory to assembling the next subprogram. 

COMPASS alters its field length dynamically, thus ensuring that central memory requirements for tables 
used by the assembler are satisfied. The assembler requests additional central memory as needed up to a 
threshold field length. (The threshold value is determined by the installation.) When the threshold field 
length is reached, the intermediate file and cross-references are transferred to the system mass storage 
device. If additional core is needed, the assembler continues to request central memory up to the 
maximum available to the job. (COMPASS may use any ECS/LCM space assigned to the job for table 
space.) If core requirements are still not satisfied, COMPASS aborts and issues a diagnostic message. 
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All nested processing of macros and similar definitions is handled in a single recursive push^down stack, 
COMPASS has a maximum recursion level of 400; that is, COMPASS allows nesting to a depth of 400. 


1.3 RELOCATABLE OBJECT PROGRAM EXECUTION 

When the assembler has completely processed the source deck, a control statement tfor example, LGO) can 
be used to eaU for loading and execution of a CPU object program from the load-and-go file. The loader 
links the newly assembled subprogram to any previously assembled subprograms and subroutines referred to 
by the new program and to programs on any other files specified by the programmer. After aU 
subprograms are loaded and linked, the operating system begins program execution at a location specified 
by one of the subprograms. Data for the object program can be on some programmer-specified file. 
Normally, this loading and execution does not take place if the COMPASS assembler detects fatal errors, 

1.4 INTERACTIVE PROGRAM DEBUGGING 

A COMPASS program that assembles without fatal errors can be executed under control of the CYBER 
Interactive Debug (CID) softw£U*e. CID allows the programmer to correct errors in program logic from a 
terminal. Using CID, the COMPASS programmer can: 

Suspend program execution at a specific location or upon occurrence of a specific trap condition, such 
as execution of a return jump instruction 

Alter location content during program suspension 

Resume execution at a specified location or at the location where suspension occurred 

A complete description of CID features and use is given in the CYBER Interactive Debug Reference 
Manual listed in the preface. 
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LANGUAGE STRUCTURE 


2 


2.1 STATEMENT FORMAT 

A COMPASS language source program consists of a sequence of symbolic machine instructions, pseudo 
instructions, and comment lines. With the exception of the comment lines, each statement consists of a 
location field, an operation field, a variable field, and a comments field. Each field is terminated by one or 
more blank characters. However, a blank embedded in a character data item, parenthesized macro 
parameter, or comments field does not terminate a field. The size of the variable field is restricted by the 
maximum statement size only. Statement format is essentially free field. 

When punched on cards, each card is considered a line. A single statement may be composed of as many as 
ten lines. Information beyond column 72 is not interpreted by COMPASS but does appear on the assembly 
listing. Thus, columns 73 through 80 can be used for additional comments or sequencing. Columns 81 
through 90 are used for sequencing by library maintenance programs; they are normally not used by the 
programmer. A line that contains two or more consecutive colons may be read and printed as two lines 
because of operating system conventions for delimiting line images. 


2.1.1 FIRST COLUMN 

The contents of column one designate the type of line, as follows: 

,(comma) Designates the line as a continuation of the previous line, 

♦(asterisk) Designates the line as a comments line, 

other Indicates the beginning of a new statement. 


2.1.2 LOCATION FIELD 

The location field entry begins in column one or two of a new statement line and is terminated by a blank. 
If columns one and two are blanlc, the location field has no entry. A location field entry is usually 
optionaL It may contain a symbol or name according to the requirements of the operaticxi field, or a plus 
sign (+) or a minus sign (-). (See Block Control Counters, chapter 3.) 


2.1.3 OPERATION FIELD 

If the location field is blank, the operation field can begin in column three. If the location field is 
nonblank, the operation field begins with the first nonblank chEiracter following the location field and is 
terminated by one or more blanks. The operation field is blank if there are no nonblank characters between 
the location field and column 30. The following are legal field entries: 

Central processor unit mnemonic operation code and, optionally, the variable subfields with each 
variable subfield preceded by a comma. 

Peripheral processor unit mnemonic operation code 
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Pseudo instruction mnemonic operation code 
Macro name 


Blank 

2J.4 VARIABLE FIELD 

The contents of the operation field determine if any entry is required in the variable field which consists of 
one or more sub fields separated by commas. The variable field begins with the first nonblank character 
following the operation field and is terminated by one ore more blanks. It is blank if there are no nonblank 
characters between the operation field and column 30. 

A variable subfield contains one of the following: 

Data item 

Expression 

Register designator 

Name 

Special element 

Entry uniquely defined for the instruction 


2.1.5 COMMENTS FIELD 

Comments are optional and begin with the first nonblank character following the variable field or, if the 
variable field is missing, begin no earlier than column 30. The beginning comments column can be changed 
through the COL pseudo instruction (chapter 4). 


2.1.6 COMMENTS STATEMENT 

A comments statement is designated either by an asterisk in column 1 or by blanlcs in columns 1-29. 
Comments statements are listed in assembler output but have no other effect on assembly. A statement 
beginning with * is not counted in line counts for IF-skipping (Section 4.9) and definition operations 
(chapter 5) and is not included in definitions. A statement having columns 1-29 blank is counted. 

2.1.7 STATEMENT CONTINUATION 

Normally, column 72 terminates a source statement that has not yet terminated. However, a statement 
that cannot be contained in the first 72 characters can be continued on the next line by placing a comma in 
column one and continuing the field in column two. A maximum of nine continuation lines is permitted for 
a statement. The break between lines need not coincide with a field or sub field separator; even a symbol 
can be split between two lines. Continuation lines beyond the ninth, and continuation lines following a 
terminated statement are considered comment lines. 
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2.1,8 CODING CONVENTIONS 

Figure 2-1 illustrates a COMPASS coding form that establishes a coding convention as follows; 


Column 

Contents 

1 

Blanks asterisk^or comma 

2-9 

Location field entry or plus, or minus left justified 

10 

Blank 

11-16 

Operation field entry left justified 

17 

Blank 

18-29 

Variable field entry left justified 

30 

Beginning of comments 


All examples in this manual abide by this convention. 


CONTROt. DATA 


COMPASS CODING FORM 



mmo M u. L A. 


Figure 2-1* COMPASS Coding Form 
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2.2 STATEMENT EDITING 


COMPASS reads statements in sequence from the source file. It immediately edits and interprets each 
statement unless (1) it is a comments statement of the type indicated by an asterisk in column one, or 
(2) it is part of a definition, that is, it is a statement between a macro or OPDEF header and an ENDM, 
between a DUP or ECHO and an ENDD, or between an RMT pair. Statements within definitions are 
saved for editing and interpretatioi yJtBn the definition is referenced or expanded, ENDD and ENDM 
are part of the definition they terminate and are not edited. Statements within the range of a conditional 
{EF type) pseudo instruction are edited even when they are skipped, COMPASS performs two types of 
editing; concatenation, and micro substitution. 

2.2.1 CONCATENATION 

COMPASS examines the statement for the concatenation character and removes it from any field of 
the statement so that the two adjoining columns are linlced. The most common use of the concatenation 
character is as a delimiter for a substitutable parameter name in a macro definition when there is no 
other type of delimiter already there to set off the parameter name. After the substitution takes 
place, the r^is superfluous and is removed by editing before the definition is interpreted. 

Each removal of shifts the remaining columns in the statement left one character. This could 
become significant when comments follow a blank variable field because the comments would be 
shifted left and interpreted as a variable field entry rather than comments. 

2.2.2 MICRO SUBSTITUTION 

COMPASS examines the statement for pairs of micro marks (r^) that delimit references to micro 
definitions (chapter 7 ) and replaces each reference (including the micro marks) with the micro character 
string referenced. The string that replaces the reference in the statement can be a different number of 
characters than the reference so that after the substitution, remaining characters in the statement are 
shifted left or right, accordingly. If, as a result of micro substitution, coliinm 72 of the last statement 
read is exceeded, the assembler creates up to a maximum of nine continuation cards, beyond which it 
discards excess without notification on the listing. No replacement takes place if the micro name is 
unlcnown or if one of the micro marks has been omitted. The micro marks and name remain in the line. 
In the first case, the assembler flags a nonfatal assembly error. However, a single micro mark is not 
illegal and does not produce an error flag. 

If the micro name is null (i. e. , the two micro marks are adjacent) both micro marks are deleted and no 
error flag is set. 

The columnar displacement caused by a micro replacement could also affect the relationship of fields 
to the beginning comments column. For example, it could shift the operation or variable field right 
beyond column 30, or could shift comments left into a blank field. 

A line that contains two or more consecutive colons after editing may be printed as two lines because 
of operating system conventions for delimiting print lines. 

2.3 NAMES 

A name is a sequence of characters that identifies one of the following: 

Subprogram or overlay 
Block 
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Macro definition 


Remote definition 

Duplicated sequence (DUP or ECHO) 

IF sequence 
Micro 

A comma or a blank terminates a name. Concatenation marl<s and pairs or micro marics are removed 
before the name is scanned (see Statement Editing). 

A CPU subprogram name or overlay name is used for linkage with other subprograms. It must begin with a 
letter (A-Z) and is limited to seven characters maximum. Conventions imposed on names by the operating 
system could restrict the use of certain characters in names. There is no restriction on the first character 
for a PPU subprogram or overlay name. For a CYBER 70 Model 76 or 7600 PPU assembly, the name can be 
seven characters, for a CYBER 180 Series the name can be four characters and for a CYBER 170 Series, a 
CYBER 70 Model 72, 73, 74, or 6000 Series PPU assembly the name can be three characters. In all cases, 
the last character of a subprogram or overlay name cannot be a colon. 

Any other type of name can consist of one to eight characters. A name does not have a value or attributes 
and cannot be used in an expression. 

The different types of names do not conflict with each other. For example, a micro can have the same 
name as a macro, or a subprogram can have the same name as a block, etc. 


2.4 SYMBOLS 

A symbol is a set of characters that identifies a value and its associated attributes. For an ordinary 
symbol, the first character cannot be a $ or = or: or a number; a symbol can be a maximum of eight 
clwacters. A symbol cannot include the following characters: 

+ - ♦ / blank , P** or A 

Other special characters must be used with care, especially in ECHO and macro definitions (chapter 5). 
Conventions imposed on symbols by the operating system could restrict the use of certain characters in 
symbols. 

An external or entry point symbol is used for linkage with other subprograms and has additional restrictions 
(see Linkage Symbols). 

Concatenation marl<s or pedrs of micro marks are removed before a symbol is examined (see Statement 
Editing). In CPU assemblies, to avoid conflict with register designators, a symbol cannot normally be An, 
Bn, Xn, where n is a sin^e digit from zero to seven nor can a symbol be A.x, B.x, or Xjc, becaiBe x is 
assumed to be a data item by the assembler. However, symbols resembling register designators can be used 
if each use of the symbol is prefixed by =S or =X. Register designators are described further under CPU 
registers. 

The process of associating a symbol with a value and attributes is known as symbol definition. This can 
occur in five major ways. 
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!• A symbol used in the location field of a symbolic machine instruction op certain pseudo instructions is 
defined as an address having the current value of the location counter (chapter 3; and having an 
attribute defined as follows: 

Absolute for the absolute block 

Common for labeled or blank common blocks (relocatable assemblies only) 

Relocatable for local blocks other than absolute during pass one 
Absolute for local blocks during pass two of an absolute assembly 

2. A symbol used in the location field of definition pseudo instructions (see Symbol Definition, chapter 4) 
is defined as having the value and attributes derived from an expression in the variable subfield of the 
instruction. Certain of these pseudo instructions assign an attribute of redefinability to a symbol. 
Unless a symbol is redefinable, a second attempt to define it with a different value produces a 
duplicate definition fatal error flag. 

3. An external symbol is defined outside the bounds of the current subprogram and is declared as external 
in the current subprogram or is defined in relation to a symbol declared as external. In either case it 
has the attribute of external. Unlike a systems symbol, the true value definition is not known to the 
current subprogram. 

4. Definitions of systems symbols that take place outside of the current program can be carried over to 
the current program through the SST pseudo instruction. COMPASS uses the true definitions but 
assigns the additional attribute of systems symboL 

5. COMPASS defines a symbol by default if a reference to a symbol is preceded by =S and the symbol is 
not otherwise defined in the subprogram. This feature is further described under Default Symbols. 

There is no restriction on the number of times that the symbol can be referred to in the subprogram. 

Examples: 



p 

5A 

First character numeric 

R3 

ABCEDEFGHI 

Exceeds eight characters 

PROGRAM 

ABE+15 

Contains plus sign 


=.11 

First character equal sign 


2.4.1 LINKAGE SYMBOLS 

A relocatable subprogram can be linked to other subprograms through linkage symbols. The two types of 
linkage symbols are external symbols and entry point symbols. An external or entry point symbol can be a 
maximum of seven characters, the first character must be a letter (A-Z), and the last character must not 
be a colon. 

Any symbol declared as an entry point in a subprogram compiled or assembled independently of the current 
subprogram can be declared as an external symbol in the current subprogram. Any symbol declared as an 
entry point in the current subprogram can be declared as an external symbol in some other subprogram. 

The symbol has a zero value and an attribute of external. An external symbol can be declared either 
through the EXT pseudo instruction or through default (a reference to the symbol is preceded by =X or =Y; 
see Default Symbols). 
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An external symbol can be strong or weak. A strong external symbol reference causes the loader to try to 
find and load a subprogram having a matching entry point symbol. Failure of the loader to satisfy a strong 
external in this way is flagged as a non-fatal error by the loader. A weak external does not require the 
loader to search for a satisfying subprogram; however if one is loaded for some other reason, the loader 
associates the matching linkage symbols in the usual way. At the end of loading, the existence of 
unsatisfied weak external symbol references is not an error. 

External symbols can be defined in the subprogram relative to any external symbol declared in an EXT 
pseudo instruction. This is possible through use of symbol definition instructions that assign the value and 
attributes of an egression to a symbol. If the value of the expression reduces to an external symbol + an 
integer, the location field symbol is defined as having an integer value and external attribute. Entry point 
symbols and external symbols are not qualified (see Qualified Symbols). 


2.4.2 DEFAULT SYMBOLS 

When a symbol reference is preceded by =S, “X, or =Y and the symbol is not defined in the subprogram, 
COMPASS defines the symbol or declares it as a strong or weak external symbol, respectively, at the end 
of assembly. The =X and =Y forms are defined by default in relocatable assemblies only. 

If symbol is not defined, COMPASS assigns an address at the end of the zero block. 
All si^sequent references to the symbol, whether preceded by =S or not, are to the 
location of the word. A default symbol cannot be used where a previously defined 
symbol is required. 

If the symbol is defined by a conventional method, COMPASS does not define it again 
but uses the programmer definition. 

This option permits a programmer to define his symbols in a subroutine or link to 
them in another subprogram. If the programmer defines the symbol, the assembler 
uses the programmed definition. If the programmer does not define the symbol, the 
assembler assumes that the symbol is a strong external as though declared in an EXT 
pseudo instruction. A symbol prefixed by =X must conform to the requirements for 
external symbols. 

=Ysymbol This option permits a programmer to define symbols in a subroutine or to link to them 

in another subprogram that need not be loaded. If the programmer defines the 
symbol, the assembler uses the programmed definition. If the programmer does not 
define the symbol and if it is not referenced elsewhere with an =X or =S prefix, or 
declared in an EXT pseudo instruction, the assembler assumes that the symbol is a 
weak external. A symbol prefixed by =Y must conform to the requirements for 
external symbols. 

The system does not define a default symbol and issues an error flag if a symbol is prefixed both by =S and 
=X, or is prefixed by =X or =Y, and is not defined conventionally in an absolute assembly. Default symbols 
are qualified by the qualifier in effect at the time of the =S reference. 


=Ssymbol 


=Xsymbol 


2.4.3 PREVIOUSLY DEFINED SYMBOLS 

Certain pseudo instructions require that a symbol in an expression be previously defined. This simply 
means that the symbol, before its use as an expression element, must be defined in a prior instruction. 
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2.4.4 UNDEFINED SYMBOLS 


A reference to a symbol that is never defined (not even by default) causes a U error flag to be placed to 
the left of the instruction containing the erroneous reference. 


2.4.5 QUALIFIED SYMBOLS 

A symbol defined when a symbol qualifier is in effect during assembly (see QUAL pseudo instruction, 
chapter 4) can be referred to outside of the qualifier sequence in which it was defined through: 

/qualifier/symbol 

The feature permits the same symbol to be defined in different subroutines without conflict. An 
unqualified symbol is global and does not require a qualifier when it is referenced, unless a qualifier is in 
effect, and a symbol qualified by the same qualifier has been defined. In this case, the unqualified symbol 
can be referenced as // symbol. 

The combination of qualifier and symbol permits a value to be identified by a unique 16-character 
identifier. Linkage symbols are not qualified. 


2.5 CPU REGISTERS 

Register designators symbolically represent the 24 CPU operating registers. The registers are described 
more fully in chapter 8. The designators are inherent to COMPASS and cannot be changed during assembly. 

In a CPU assembly, symbols of the same form as register designators may be used if each occurrence of 
such a symbol is prefixed by =S, =X, or =Y (see Default Symbols). However, a warning message is i^ued 
when such symbols are defined. The prefix cannot be used in the location field of machine instructions and 
symbol defining, data generating, BSS pseudo instructions, in the variable field of ENTRY, EXT, and SST 
pseudo instructions. 

Register Type 

Address 

Index Bn or B.n 

Operand Xn or X.n 

For the forms An, Bn, or Xn, n is a single digit from 0 to 7. Any other value for n, for example 8, causes 
An, Bn, or Xn to be interpreted as a symbol rather than a register designator. 

For the forms A.n, B.n, X.n, n can be a symbol or an integer. If the value of n or the value of the symbol 
exceeds 7, the assembler truncates it to the least significant 3 bits and issues a warning flag. 

Registers designated by A1 through A5 or A.l through A.5 are used for addressing to obtain information 
from central memory. Registers designated by A6, A7, A.6, or A-7 are used for addressing to place 
information into central memory. 


Designator 
An or A.n 
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COMPASS does not recognize registers in PP assemblies; there, the designators are acceptable as ordinary 
symbols. 

Examples: 

A1 Designates address register 1 

AlO Interpreted as a symbol, not a register 

A*1 Designates address register 1 

A.NUM If the value of NUM is 6, it designates address register 6 

A.IO Designates address register 2; however, it produces a warning flag because the two was 

derived from the truncation of 12, the octal value for 10. 

The following produce equivalent results. A SET pseudo instruction (chapter 4) defines SUM and SUB as 
absolute values 3 and 2, respectively. A reference to a SET-defined symbol produces the same result as if 
the value had been used directly. In this example, the address of ALPHA is 001000. 
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Code Generated 


tOCATlON 

OPERATION 

VARIABLE 

COMMENTS 




tl 

IB 

ho 

6032001000 



|SB3 

A2+flLPHA 


3 

2 

6032001000 



LOCATION 

OPERATION 

VARIABLE COMMENTS 



i1 

16 ho 


SUH 

SUP 

SET 

SET 

S8.SUM 

-h— - 

3 1 

2 1 

A.SUR+ALPHA | 


2.6 SPECIAL ELEMENTS 

The following designators sre reserved for use as reference to special elements and cannot be used as 
symbols. The use of a special element in an expression causes the assembler to replace it with a value 
specified by the element in the expression. The control counters are discussed further in chapter 3. 

Designator Significance 

♦ or *L The assembler uses the value of the location counter for the block in use. 

The element is relocatable unless the counter in use is for the absolute block. 

*0 The assembler uses the value of the origin counter for the block in use. The 

element is relocatable unless the counter in use is for the absolute block. 

$ The assembler uses one less than the absolute value of the position counter 

for the block in use. 

♦P The assembler uses the absolute value of the position counter for the block 

in use. 

The assembler uses an absolute value obtained as follows: 

0 COMPASS was called by a COMPASS control statement 

1 COMPASS was called by the RUN compiler (no longer supported) 

2 COMPASS was called by the FTN4 compiler 

3 COMPASS was called by the FTN5 compiler 


♦F can be redefined by the COMPASS control statement F parameter 
(chapter 10). 

These designators are inherent to COMPASS and cannot be altered by the programmer during an assembly. 
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Examples: 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


11 

IB ho 



JO 

■ 

*+l+R7 1 

1 



• 

ZR 

• 

1 

X3,*L-1 , 

1 



m 

LOG 

• 

•0-^.ES + PPR ^ 

1 



• 

vpn 

• 

1 

1 



• 

VF[) 

• 

i 

£/0,l/l 1 

1 



IPEQ 

1 

*F,.? 1 


2.7 DATA NOTATION 

Data notation provides a means of entering values for calculation, increment counts, operand values, line 
counts, control counter values, text for printing out messages, characters for forming symbols, etc. 

The two types of data notation are character and numeric. The assembler allows the user to introduce data 
in the program in three basic ways; 

As a data item 

As a constant in an expression 
As a literal 


2,7.1 DATA ITEMS 

Character and numeric data items can be used in subfields of the DATA and LIT pseudo instructions or as 
specifications of field values on VFD pseudo instructions. 


2.7.2 CONSTANTS 

A data constant is an expression element consisting of a value represented in octal, decimal, hexadecimal, 
or character notation. It resembles a data item but is restricted by its use as an expression element in two 
ways; 
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1, The first character must be numeric, prohibiting the delimited type of character string (see Character 
Data Notation) and the preradix for numeric values. 

2. The field size is determined by the destination field for an expression and can be a maximum of 60 bits 
thus prdiibiting double precision floating point numbers- 


2.7.3 LITERALS 

A literal is a read-only constant. It is specified as a data item in a subfield of a LIT pseudo instruction or 
as an element in an expression. 

The method of specifying a literal in an address expression is nearly identical to that for specifying a data 
item in a DATA or a LIT pseudo instruction. The primary difference is that the literal is prefixed with an 
equal sign, which indicates that a literal follows. 

When a literal is used as an element in an expression, the expression is evaluated using the address of the 
literal in the literals block rather than the value of the data item. Thus, the literal is considered 
relocatable. (For a discussion of the literals block, see chapter 3.) 

Conventionally, if a literal is used, it is the only element in an expression. 

The first use of a literal causes the assembler to assemble the data specified by the literal, and store the 
data in the literals block using as many words as are required to hold the data. If the binary pattern of the 
prefixed type of literal or of aH the literals in a LIT declared sequence matches the binary pattern of words 
previously entered in the literals block, an entry is not generated for the data. This process eliminates 
duplication of read-only data. 

The LIT pseudo instruction permits symbols to be associated with literals block entries. Such entries can 
be referenced symbolically or through use of a prefixed literal. However, to preseve the integrity of the 
literals block, they should be used as read only locations. 

The assembly listing includes a list of the literals block when the D list option is selected (see Listing 
Control, chapter 4). 

Example: 

In the following example, using CPU instructions, the first statement creates a word in the literals 
block having the value 00000000000000000001. The address of that entry (for the purpose of the 
example) is 5555 and is used in the address field of the ty^o statements at address 100 and the 
statement at the lower part of 101. 

The literal in the second statement specifies a right justified character, A, which has a display code 
value of 1. The SB4 creates a one-word literal block entry having the value 00000000000000000002. 
The address of that entry is in the address field of statements at the upper half of addresses 101 
and 102. In this example, the LIT sequence duplicates a sequence of entries in the literals block and 
does not cause new entries to be assembled. 
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Location Code Generated 


LOCATION 

OPERATION 

VARIABLE COMMENTS 


1 


ri 

IB 1 30 

100 612Q0Q5555 + 



SB2 

=1 1 

6130005555 



SB3 

=li?A ' 

101 61400Q5556 f 



SB4 

=ipn 1 

5555 


L 

LIT 

1.? 1 

6120005565 + 



SB2 

L ' 

102 6130005556 + 



503 

L+l 1 


CONTENT OF LITERALS BLOCK. 


QQ655^ QQOOOQOnOOnOOQIOOOni a 

D05556 DnoQOQQnnoQnooonoon? 0 


Continuing the previous example, a LIT sequence as illustrated below, does not duplicate a sequence in the 
literals block and causes entries to be generated in the literals block; 


Location 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


ri 

IB 

l3D 





T 

5557 



LIT 



I 


CONTENT CF LITERALS ELCCK. 


00555*^ oanooQOoonaaoooooQOi a 

00*^556 noaoaonnoflooannooooe b 

D05557 GOOnoaonGOOnODDOnOOi A 

oo«556T 0(1 DOGoanononnonoooo? r 

GOBS 6 I 0 0 00 0 0000 00 0(10000 004 D 

00B562 00000000000000000002 B 


However, if the literals sequence in the first part of the example had been followed by a LIT that 
duplicates, in part, the most recent entries in the literals block, only the unduplicated part is added to the 
block. Thus, if the following LIT sequence had been used in place of the LIT l,3,iRD,2, the first two words 
of the sequence would match the last two words of the literals block so that only two additional words 
would be required to complete the sequence. 


Location 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


n 

IQ 

ho 






5555 1 



LIT 

1,2,7,4 \ 


CONTENT OF LITERALS BLOCK. 


0055*5*^ onnnooornooononoonoi a 

005556 OQOODDOnoQtlOOOOOQQO? n 
005557 ooonooQGOoononnnooo? r 
005560 00000000000000000004 q 


2.7.4 CHARACTER DATA NOTATION 

Character data strings are converted to the code in use at the time the string is evaluated (see CODE 
pseudo instruction, chapter 4), and placed in a field indicated by the data type (data item, constant, or 
literal). When no CODE instruction has been issued, conversion is to display code representation. 
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Format: 


Data Item 


Constant t 
Literal t 


d 


sign 

0 

type 

string 

1 



or 



sign 

type d 

string 

Z! 



type 

string 

1 






0 

sign| 

N 

type 

string 


or 


E 

sign 

type 

0 

string 


Example 

-3RABC 


-R*ABC* 

3RABC 

--3RABC 


=-R+ABC* 


~ Applies to literals used as expression elements only; signifies that a literal follows. 

sign Optional for data item or literal. A sign with a constant is interpreted as an element operator, 

+ or omitted The value is positive 

The complemented (negative) value is formed 

n Signifies how the string is determined: 

omitted The string is delimited by d. n cannot be omitted for a constant, 

0 For data item or literal, the string consists of all characters following type 

to: 

blank or , 

For a constant, string consists of all characters following type to: 

+ - ♦ / blank , at A 

The A (caret) is in the CDC character set. In the ASCII character set, use 
the (5c (ampersand). 

n For a data item or literal, n is an integer count of the number of characters 

in the string not counting guaranteed zeros. It is limited only by statement 
size. 

For a constant, n is an integer count of the number of characters in the 
string. It cannot exceed 1/6 of the number of bits in the field that will 
contain the expression. A truncation error is flagged for a right justified 
constant if the most significant bit exceeds the field. Truncated zeros do 
not cause an error in this case. A truncation error is flagged for a left 
justified constant if the least significant bit positions are truncated, even if 
they are zero. 

The string consists of the n characters following type. 

Regardless of base, COMPASS assumes that n is decimal. 


tExpression element 
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type Character string justification. The characters formed by the data item or constant are right 
or left justified into the destination field as follows; 

Type Significance 

C Left justified with zero fill. For data item or literal, 12 zero bits are 

guaranteed at the end of the string even if another word must be 
allocated. For a constant, C is the same as L; the 12 zero bits are not 
guaranteed. 

H Left justified with blank fill 

A Right justified with blank fill 

R Right justified with zero fill 

L Left justified with zero fill 

Z Left justified with zero fill- For data item or literal, six zero bits are 

guEU’anteed at the end of the string even if another word must be 
allocated. For a constant, Z is the same as L; the six zero bits are not 
guaranteed. 

d A delimiting character used only when n is omitted. The characters between the first 

occurrence of d and the second occurrence of d form the string, d can be any character other 
than r^or 7 ^. 

string Characters from one of the COMPASS character sets (appendix A), except for those 

characters that act as delimiters (see n and d), the concatenation character (p^), and pairs of 
micro marks (t^). 

Concatenation marlcs and pairs of micro marks are removed by editing before a string is 
examined. A single micro mark can be used in a string. 

An empty or omitted character string is defined under one of the following conditions; 

n is 0 and type is immediately followed by a delimiter, for example, OL. 

n is omitted and the two delimiting characters are adjacent, for example, H+ +. 

Omission of a string in a DATA pseudo instruction is legal and does not cause generation of a 
data word. 

For a constant, an omission of the string is valid and has a zero value. 

An omitted string in a LIT pseudo instruction is legal and does not cause generation of a 
literal for that item; however, the LIT must contain at least one non-empty data item. 

An omitted string for a literal in an expression is not legal and produces an error. 

It is not possible to generate empty strings using types C, Z, R, or A. 


60492600 H 


2-15 







Examples of character data: 

In these examples, characters are converted to display code representation; all lines of code generated 
by DATA are printed only if the D or G list option is selected 

Data Items 


Location Code Generated 


LOCATION 

OPERATION 

VARIABLE COMMENTS 


1 


11 

IB Uo 

144 Q52222172P5511165520 

145 0421550PnOI]OaOOOODOn 

146 55555555555555555555 

LocaldoD Code Generated 



DAT'\ 

L*ERrtOR IN POa 


LOCATION 

OPERATION 

VARIABLE COMMENTS 

1100 1725 

1101 2420 

1102 2524 

1 


11 

18 |30 



PPU 

• 

DATA 

-- 

1 

1 

OLOUTPUT 1 


Constants 


Location Code Generated 


LOCATION 

OPERATION 

variable comments 



1 


11 

IB ha 

4722 

7130000047 



SX3 

IR* [ 

4723 

7140000060 


TAG 

bX4 

1R|*.<-1 1 


5110031117 



SAl 

3RCI0 1 

4724 

6260530000 



SB6 

XO+ILJ 1 


1117240155 



VFU 

3 0/4HIUT A,6/1R4,24/OAX + l 

4725 

0155555531 




1 


1725242025 



VFD 

42/OLOUTPUT,18/1 

4726 

2400000001 




1 


0700000000 



VFD 

15/0LG,15/0L| 


Note that the character constant in the expression in the second line consists of a decimal point (57 in 
display code) to which 01 is added before the value is stored. Similarly, in the third field of the first VFD, 
1 is added to the display code representation of X right justified with blank fill (55555530) so that 55555531 
is generated, 
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Literals 


Location Code Generated 


100003765 

100003770 

2652 5110003772 ^ 

5120003774 f 

2653 5130003767 + 



tOCATION 

OPERATION 

VARJABIE COMMENTS 

± 



IQ ho 


TA&l 

LIT 

LIT 

SA? 

CAT 

(A,6L) 5= t . fTCn tOL 
^OHLITERALS 
^TCTENCHARPTS 

^H+LFFT JUSTIFY WITH PLANKS+ 
-HLn 


content of literals block. 


0 03765 000000000 04 5464 75051 
003766 52535455565700000000 
Q03767 33000000000000000000 
003770 14112405220114235555 
003771 55555555555555555555 
003772 24051603100122032423 
0 0377 3 OOOnOOQQOOQOQOOOOOOO 
003774 14050624551225232411 
003775 06315527112410550214 
003776 01161323555555555555 


0 

LITE*?flLS 

TFNCHflRCTS 

LEFT JUSTI 
FY WITH PL 
AMKS 


The first LIT pseudo instruction generates three words in the literals blockj the OL item is an empty string 
and does not produce an entry. The second LIT pseudo instruction generates one two-word entry. The 
expressions in the variable fields of the SAl, SA2, and SA3 instructions each consist of a literal element. 
The character strings in the SAl and SA2 literals do not duplicate former literals block entries so 
COMPASS generates new entries. However, since SA3 references an existing entry, COMPASS places the 
address of the entry in the address field of the instruction. 


2.7.5 NUMERIC DATA NOTATION 


Numeric data can be specified in octal or decimal notation. The value is converted to an integer or a 
floating point value in single or double precision. 

Formats: 

Data Item 


Constant 

Literal 


sign 

pre radix 

value 

modifiers 


value 


modifiers 


sign 

preradix 

value 

modifiers 
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sign 


preradix 


Applies to literals only; signifies that a literal follows. 

Optional for data item or literal; a sign with a constant is interpreted as an element 
operator. 


+ or omitted 

The value is positive 

The complemented (negative) value is formed 

Optional for data items and literals; cannot be used for constants. The preradix 
indicates the notation used for the value. 

omitted 

Notation can be specified by a postradix modifier or can be 
assumed from the assembly base. See BASE pseudo instruction. 

B or 0 

Octal notation 

D 

Decimal notation 


value A series of octal or decimal digits optionally consisting of an integer, a decimal (or 

octal) point, and a fraction. An integer value (fixed point) does not contain a point. 
A floating point value (legal in CPU assemblies only) is noted by the occurrence of 
the point. 


An octal value can be a maximum of 20 significant digits (fixed point) or 32 significant 
digits (floating point). An octal value cannot include 8 or 9. A decimal value cannot 
exceed 1,15 x 10^® (fixed point) or 7.9 x lO^® (floating point, ignoring the decimal 
point). Extra significant digits cause erroneous results. 


If value is omitted, it is assumed to be zero. 

modifiers Associated with the value are the following optional modifiers specified in any secjiience. 

A specific type of modifier can be specified only once. A duplicate produces an error 
flag. 


postradix Indicates the notation used for the value. See preradix for legal values. 

An error is flagged if notation contains both a preradix and a postradix. 

decimal exponent Defines a power of 10 scale factor 

E+n or En or E Single precision 

EE+^n or EEn or EE Double precision 

When the sign is plus or is omitted, the exponent (n) is positive. 

When n is omitted, it is assumed to be 0. The value of n cannot exceed 

32767 and is always assumed to be a decimal integer. 

A fixed point value can be single precision (one word) only but a CPU 
floating point value can be generated in double precision (two words). 

If EE is used with a fixed point value, the assembler produces a fixed point 
number in single precision. 

The e:fiect of the exponent is to multiply the value by 10 decimal raised 
to the n power. 
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Defines a power of two scale factor and is specified as follows: 

S+n or Sn or S 

When the sign is plus or is omitted, the scale factor (n) is positive. When n 
is omitted, it is assumed to be 0. The value of n cannot e^cceed 32767 and 
is always assumed to be a decimal integer. 

The effect of the binary scale is to multiply the value by 2 raised to the n 
power. 

Applies to floating point values only and is specified as follows: 

P+n or Pn or P 

When the sign is + or omitted, n indicates the number of bit positions the 
point is to be shifted to the left of bit 0. When the sign is n indicates the 
number of bits the point is to be shifted to the right. 

The effect of P is to align the value so that the binary point occurs to the 
right of the nth bit. 

The exponent is adjusted to a value of - (+n) 

For example, a value with P-6 will have a biased exponent of 2006g. a 
value with PIO will have an exponent of 17658. * 

If P is not speeitied for a floating point number or if n is omitted, the 
assembler generates a normalized floating point value. The P modifier 
permits generation of an unnormalized value. 

If, as a result of P, the most significant bit of the value is shifted out of 
the coefficient part of the single or double precision number, the assembler 
generates an overflow or underflow error. 

Although scale factors can exceed valid ranges, the ranges for numbers are restricted by 
the hardware. 

Example: 

The number 1.0E400S-1200 yields a number that is approximately 5.8 x 1038 and is 
in range of the floating point representation. 

All calculations are performed in 144-bit precision. The values are rounded to 96 bits for 
doit»le precision and to 48 bits for single precision floating point numbers and to 60 bits for 
integers. 

The order in which the assembler acts on the modifiers, regardless of the sequence in which 
they are specified, is: 

1. Decimal exponent (single or double) 

2. Binary scaling 

3. Binary point position (CPU assemblies only) 


binary scale 


binary point 
position 
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CPU Numeric Data IteniB 


Location Code Generated 


3000 

3001 17-> 3s0300c00a0000000 

5002 i^Aoooooocooocacoooc 

5003 2000300O0C000COCOO12 

500^ 1 ■'7fi00000c0000000002 

500 5 171 *54651767635544264 

5006 17300314631463146314 

5007 77777777777777777777 
5n0fi 003000000000000COOOO 



lOCAllON 

OPERATION 

VARIABLE 

COMMENTS 

1 


l( 

IB 

ho 






POCl 

NUN 

DATA 

DATA 

-2 9 
l.CEfl 

;- 

1 

1 



DATA 

DATA 

DATA 

DATA 

1®0E41P0 
3.2PlS-5n 
O.Cl 51Ff01 
0.1P47 ,-Er 

1 

1 

DEES 

1 


CPU Numeric Constanta 


Location Code Generated 


LOCATION 

OPERATION 

VARIABLE COMMENTS 


1 


1) 

IB ho 

5001 ♦ 


alpha 

EOU 

POOL+l 1 

555 


VAL 

EOU 

555B ' 

9012 



Bssr 

lOCB 1 

9112 20360 



LX3 

-14B 1 

4376C 



HX7 

48 

715C4C0000 



SX5 

1S17 1 


CPU Numeric Literals 


Location Code Generated 


511 3 5150005151 ♦ 

5130005152 

5153 

5155 

5156 

5157 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


11 

IB |3D 


ABLE 

SA5 

SA3 

LIT 

LIT 

LIT 

LIT 

-200467550 00 23400b004B 
-1.1 1 

l.CEFl 1 

0.1P47 ' 

-D19 1 

0.0151E+01#-E.D£E5 


CONTENT OE LITEP41S BLOCK. 


005151 200467550C0234000C04 

005152 17704314631463146315 

005153 1723500COOOOOOOOOOOO 
005154 1643000COOOOOOOOOOOO 
005155 17200314631463146314 

005156 77777777777777777754 

005157 17154651767635544264 

005160 77777777777777777777 

005161 OOOOOOOCOOOCOOOOOCOO 


POa 

B1 

D 

DPBLi 

III 

LJH 

as/ 



NB 



OPCLI 

HI 

LiL 


;; 

5 p * 
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Examples of numeric data (assume default radix is decimal): 


PP Data Items 


Location 

Code Generated 

300 

0005 

301 

7766 

302 

0013 

3Q3 

0030 

304 

0002 

PP Constants 

Location 

Code Generated 

305 

oono 

306 

QOtl 

307 

4443 

310 

31 

101 

7777 

PP Literals 

Location 

Code Generated 

311 

2000 1103 

313 

2100 1104 

310 

2000 ItOS 


LOCATION 


OPERATION 


PPU 


DATA 


VARIABLE 


COMMENTS 


ITT 


* I 

5,-9D,+B13,14851,240E-1 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 



11 

IB 

[so 



roM 


—1- 

1 


Apr 

M ir 

rOM 

5PT 

COM 

-3374 

OlQl 

7777 

1 

1 


LOCATION 


OPERATION 


n 


LOC 

ADC 

LOC 


VARIABLE 


• IDO 
=•1 
-7777 


COMMENTS 


Uo 


CONTPNT OF LITERALS BLOCK* 


1103 

1104 
1100 


0012 

7776 

7777 
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2.7.6 HEXADECIMAL DATA NOTATION 


Numeric data can be specified in hexadecimal notation* The value is converted to an integer in single 
precision. 

Formats: 

Data Item 

Constant 

Literal 


sign 


preradix 


preradix 


value 


value 


modifiers 


modifiers 


0 

preradix 

value 

modifiers 


sign 


= Applies to literals only; signifies that a literal follows. 

sign Optional for data item or literal; a sign with a constant is interpreted as an element 

operator. 

+ or omitted Value is positive. 

Complemented (negative) value is formed. 

0 The zero is optional for data items and literals but must be present for constants, so the 

preradix will not be taken as the first character of a symboL 

preradix Must be present to indicate that a hexadecimal value follows. The preradix character is = 
or # depending on the printer used. 

value A series of hexadecimal digits. Each hexadecimal digit represents 4 bits and is either a 

decimal digit 0-9 or a letter A-F. The digits 0-9 represent values 0-9 and the letters A-F 
represent the decimal values 10-15. 

The value may contain up to 26 significant hexadecimal digits. No radix point is 
permitted. If value is omitted, it is assumed to be zero. 


modifiers The binary scale (S) modifier is optional and has the same form and meaning as for octal 
and decimal data (see Numeric Data Notation). 

The binary point position (P) modifier is permitted but ignored, since it does not apply to 
integer values. 


Examples of hexadecimal data: 


T r^riHo f^onor*a f-orl 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 



1 



Ifi 

ho 

□ 

1 

OOO0O0OGO0O004435274 

77777777777777777777 



DATA 

=123ABC,-^ 

^-□=AAAAA,=1234S12 

i 

2 

77777777777775252525 





1 

3 

00000000000110640000 


i 

• .. .| 

1 



4 

00000000000053012566 


X 1 

1 CON 

□^A01576 


5 

7130000006 + 


HEX j 

SX3 i 

=-=12345S2 

! 




CONTENT 

OF LITERALS BLOCK. 

1 

1 

6 

77777777777776671353 




1 

1 
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2.8 EXPRESSIONS 


Entries in subfields of most source statements are interpreted as expressions consisting of a combination of 
one or more terms- Each term consists of one or more elements joined by operators- A comma or a blank 
terminates the expression. 

An expression element can be a: 

Symbol 

Numeric or character constant 
Special element 

Examples of elements: 

ALPHA A.7 3HABC 

$ X3 =10HOUTPUT 

♦P 77BS3 

A term can be a single element or two or more elements joined by the following element operators: 

* Multiplication 
/ Division 

An expression can be a single term or two or more terms joined by the following term operators: 

+ Addition 
Subtraction 
A Exclusive or 

The exclusive or operator is printed as a (carat) in the CDC character set or as & (ampersand) in the ASCII 
character set. 

Rules: 

1. If the last element of a term is omitted, COMPASS provides an element of zero. For example, if 
ABLE is a symbol, ABLE^+3 is interpreted as the value of ABLE times 0 plus 3. 

2. Two successive elements are illegal- Note, however, that ♦♦ is legal because the first asterisk is 
interpreted as an element, the second asterisk is interpreted as an operator, and the blank is 
interpreted as a null element. 

3. A term can contain one relocatable or external element only. Thus, ♦♦ABLE, where ABLE is a 
relocatable address, is illegal because ABLE and * are both relocatable. 

4. The element to the left of a divisor must be absolute. 

5. Division by zero results in zero with no error- 

6. Two or more additive operators (+ or - or a ) in sequence are interpreted as having a term of zero 
value between them. 

7. If an expression begins with an additive operator (+ or - or A), COMPASS provides a term with zero 
value preceding the operator. 

8. AU arithmetic in expression is performed in integer mode, even if an element is a floating point 
constant such as 2.3. Results are restricted to 60 bits; that Is, if a term or value exceeds 60 bits, the 
excess high-order bits are discarded without comment. 


Register designator (CPU only) 
Literal 
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The operator that immediately precedes a register designator is the register operator, regardless of the 
placement of the designator in the expression. The register operator can be: 

+ - * or / 

Examples of expressions: 


ABLE 

Single term 

$-29 

Two terms: $ and 29 

l+=3.14159EE+6 

Two terms: a constant and the address of a literal. COMPASS places the 
literal in the literal block and uses its address in the expression. 

♦+3 

Two terms: vfidue of the location counter and numeric constant 3. 

ABLE*4-72/NUM 

Two terms, each consisting of two elements: the value of ABLE times 4, 
and 72 divided by the value of NUM. 

lOB 

Single term consisting of a numeric constant. 

3+A6-NUM 

The components of the expression are register A6 and 3-NUM. 

1R= A IR/ 

The character constants (= and /) are logically differenced. 


2,8J TYPES OF EXPRESSIONS 

Evaluation during assembly reduces an expression to: 

An absolute value (absolute address or an integer value) 

An external symbol + a 21-bit integer 
+ relocatable value + a 21-bit integer 

Register designators and one of the above (CPU assembly only) 
Register designators (CPU assembly only) 


Absolute Expressions 

An expression is absolute if its value is unaffected by program relocation. An expression can be absolute, 
even though it contains relocatable terms, under two conditions: 

The expression contains an even number of relocatable elements. 

The relocatable elements must cancel each other. That is, each relocatable element (or multiple 
thereof) in a block must be canceled by another element (or multiple thereof) in the same block. In 
other words, pairs of elements in the same block must have signs that oppose each other. The 
elements that form a pair need not be contiguous in the expression. 
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Examples of absolute expressions: 


In the following examples, EASY and FOX are relocatable in the same block. MIKE is absolute. The 
control counters are for the block that contains EASY and FOX. 


EASY-FOX+MIKE 

FOX-* 

MIKE+16 

*-EASY-FOX*2 


EASY and FOX cancel each other. 

FOX and the location counter cancel each other. 
The expression contains no relocatable elements. 
EASY and the location counter cancel 2 times FOX. 


Relocatable Expressions 

An expression is relocatable if its value is affected by program relocation. A relocatable expression 
consists of a single relocatable term or, under the following two conditions, a combination of relocatable 
and absolute terms: 

The expression does not contain an even number of relocatable elements 

All the relocatable elements but one must be organized in pairs that cancel each other. That is, for all 
but one block, each relocatable element (or multiple thereof) in a block must be canceled by another 
element (or multiple thereof) in the same block. The elements that form a pair need not be contiguous 
in the expression. 

The uncanceled relocatable element can have three kinds of relocation: 

Positive program 
Negative program 

Positive common (Negative common relocation is not permitted by the loader.) 

Examples of relocatable expressions: 

In the following examples, EASY and FOX are relocatable in the same block. MIKE is absolute. LIMA 
is relocatable in a different block. The control counters are for the block that contains EASY and 
FOX. 

LIMA+MIKE-16 
FOX-EASY+FOX 
3*FOX-2*EASY 
EASY-*+FOX 
FOX-IOOB/MKE 
-MIKE*2+UMA 
=10HMESSAGE 33 
-*0 

The pairing of relocatable terms cancels the effect of relocation because both terms would be relocated by 
the same amount* The comparative value of the two terms remains the same regardless of program 
relocation. 
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External Expressions 


An expression is external if its value depends upon the value of a symbol defined outside of the current 
subprogram. Either an external expression consists of a single positive external term or, under the 
following conditions, an external expression may consist of an external term, relocatable terms, and 
absolute terms. 


The expression contains an even number of relocatable terms. 

The relocatable elements must cancel each other. That is, each relocatable element (or multiple 
thereof) in a block must be cancelled by another element (or multiple thereof) in the same block. In 
other words, pairs of elements in the same block must have signs that oppose each other. The 
elements that form a pair need not be contiguous in the expression. 


Examples of external expressions; 

In the following examples, XYZ and ABC are external symbols. EASY and FOX are in the same block. 
The control counters are for the block that contains LIMA. MIKE is absolute. 


XYZ-*+FOX-EASY+LIMA 

FOX-3*EASY+2*FOX+XYZ 

ABC+IOOB+MIKE 

XYZ+ABC 

-ABC+*-LIMA 

XYZ+*0 


The pairs * and LIMA, and FOX and EASY cancel each other. 
The relocatable elements aU cancel. 

MIKE and lOOB are absolute; no relocatable elements. 

Illegal; both are external. 

Illegal; ABC is negative. 

Illegal; *0 is an unpaired relocatable element. 


Register Expressions 

An expression is a register expression if, in a CPU assembly, it reduces to one or more register designators 
and an operand. The attributes of the operand can be that of an absolute, external, or relocatable 
expression. Use of register expressions is generedly restricted to symbolic CPU machine instructions. If 
the register designator is the first element in the expression, the operator can be omitted and is assumed to 
be +. 

Examples of register expressions: 

In the following examples, XYZ is an external symbol and LIMA is a relocatable symbol. 

X3+LIMA-10B "J 

LIMA+X3-10B > Produce identical results 

-10B+LIMA+X3 / 

Bl+XYZ 

♦+A.NUM 


Evaluatable Expressions 

An evaluatable expression is an expression that does not contain any symbols as yet undefined. Certain 
pseudo instructions require that the expressions be evaluatable. 
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2.8.2 EVALUATION OF EXPRESSIONS 


When evaluating an expression, COMPASS replaces each element with a 60“bit value. A character constant 
is first right or left adjusted in a field the size of the destination field and then extended to 60 bits. Signs 
are extended for 21-bit quantities, that is, for counters, addresses, and symbols. In division, the integral 
portion of the quotient is retained; any remainder is discarded. Thus, 5/2*2 results in 4. 

COMPASS forms a term value by interpreting each element and operator from left to right until it reaches 
a + or - or operator. It then notes whether or not the newly formed term contains a relocatable or 
external symbol or register designators. The value of the symbol is added, subtracted, or differenced from 
the cumulative sum of the absolute elements, relocatable elements, or external values. The assembler 
continues evaluating the expression until it is reduced to a symbol and/or a value. An error is flagged if 
the expression cannot be reduced. The expression value is truncated, if necessary, and placed in the 
destination field. If it is too large for the field, the system issues an error flag. The maximum field size 
for an expression is 60 bits. 

The value of an external symbol is zero if the external symbol is defined outside of the subprogram. It is 
the value relative to the external used in defining the symbol if the external symbol was defined within the 
subprogram. 

A zero value is used in place of a register designator. 

For pass one evaluation, COMPASS uses the value of a relocatable symbol relative to the block in which 
the symbol was defined. For pass two evaluation, COMPASS uses a value relative to program or common 
block origin. 

The field size for an expression depends upon the instruction and is determined as follows: 

For a symbol definition pseudo instruction, the expression value (Including character constants) is 
justified in a 21-bit field. 

In a VFD pseudo instruction, the expression is placed in a field of the size specified. 

For a CON pseudo instruction, the fi^d size is one word (12 or 16 bits for PP assemblies, 60 bits for | 
CPU assemblies). 

In a symbolic machine instruction, values of expressions are placed in address fields (18 or 6 bits for 
CPU assemblies; 18, 16, 12, or 6 bits for PP assemblies). | 

Some relocatable program loaders may give unexpected results if relocatable or external address values are 
assembled into the same field of the same word more than once, as a result of ORGing backward over the 
word, or by having more than one subprogram preset a common block. The ORGC pseudo instructon (see 
Block Counter Control, chapter 4) can be used to avoid such problems. 
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PROGRAM STRUCTURE 


3 


This chapter is designed to give the programmer a better understanding of how a program is assembled, 
loaded, and executed. This discussion of program structure is at the machine executable level, the level at 
which code is loaded into memory and executed. 

A COMPASS subprogram consists of statements beginning with an IDENT pseudo instruction and ending 
with an END pseudo instruction. The user can designate a subprogram to be a main program by specifying 
a transfer address in its END pseudo instruction. 

The programmer can control the assembly of COMPASS source statements so that subprograms are divided 
into blocks of binary code. These blocks can be controlled during the loading process. The first section of 
the chapter presents subprogram block concepts and how the programmer and the assembler organize 
object code into blocks. Following this is a brief description of the counters used to control the blocks, 

A subprogram loaded into central memory can be either absolute or relocatable. An absolute subprogram is 
loaded at the same fixed address every time; a relocatable subprogram can be loaded into different 
locations, according to the available central memory at load time. Sections 3.3 and 3.4 discuss the 
structure of absolute and relocatable programs, respectively, and show the differences in block usage for 
both types. 

Limited available central memory occasionally requires the use of overlays and partial binary sections in 
lengthy programs. Section 3.4 covers the use of these important programming tools. 


3.1 SUBPROGRAM BLOCKS 

A subprogram, whether assembled as absolute or relocatable, can be divided into subprogram areas called 
blocks. As assembly of a subprogram proceeds, the assembler or the programmer designates that object 
code be generated or that storage be reserved in specific blocks. By properly assigning code sequences, 
data, or reserved storage areas to blocks through use of ORG or ORGC, USE or USELCM, a programmer 
can intersperse instructions for the different blocks. The assembler assigns locations in a block 
consecutively as it encounters instructions destined for the block. A symbol defined within a block is not 
local to the block. That is, it is global and can be referred to from any other block in the subprogram. To 
render a symbol local to a sequence of code requires use of the QUAL pseudo instruction (section 4-4.3). 

Blocks established between two IDENT instructions, or between an IDENT and END, form a group of 
blocks. COMPASS recognizes a maximum of 255 blocks in a single block group, 252 of which can be 
user-established. When COMPASS interprets an IDENT or END pseudo instruction, it begins pass two 
processing of the completed block group. 

In pass two all symbols are assigned absolute values, the table of block names is cleared, the list of USE, 
USELCM, ORG, and ORGC instructions is cleared, and block structuring restarts. For END, the symbol 
table is cleared before the next subprogram is assembled. If the group does not contain a USE instruction 
or if object code is generated (or storage reserved) before the first USE instruction, COMPASS places the 
code in the nominal block (identified as PROGRAM* on the listing). For an absolute program, the nominal 
block is the absolute block. For a relocatable program, the nominal block is the zero block. The user 
controls use of the nominal block and any user-established blocks through USE, USELCM, ORG, and ORGC 
pseudo instructions (section 4.5). Each occurrence of a non-redundant literal constant causes an entry in 
the literals block; otherwise, the user has no control of this block. 
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3.1.1 ABSOLUTE BLOCK 


The absolute block is the nominal block for an absolute assembly. It is identified by the name PROGRAM^ 
on the listing. All code generated in the block is absolute- Each address symbol is defined during pass one 
as an absolute value relative to zero which is block origin- The code generated must be loaded and 
executed at the origin specified as the absolute block origin. 

NormaRy, a relocatable assembly does not contain an absolute block. It may have one established, 
however, if the programmer issues an ORG (or ORGC) request using an absolute value. The assembler 
generates text tables specifying absolute block relocation- The loader loads the absolute text when it 
encounters the text table, without manipulating any addresses. For a relocatable assembly, an absolute 
block is identified on the assembly listing by the name ABSOLUTE*. There is no ECS/LCM absolute block. 


3.1.2 ZERO BLOCK 

The zero block has the block name 0 and is the nominal CM/SCM block for a relocatable assembly. It is a 
local block; that is, it is not accessible to other subprograms. Upon completion of assembly, the assembler 
assigns any undefined default symbols at the end of the zero block. The zero block is identified by the 
name PROGRAM* on the assembler listing. 

An absolute program has a zero block only if the program contains default symbols. In an absolute 
assembly, the zero block immediately follows the absolute PROGRAM* block. The zero block is also 
named PROGRAM*. 

There is no ECS/LCM zero block. 


3.1.3 LITERALS BLOCK 

COMPASS generates literal data entries in the literals block. It is local to a subprogram. The literals 
block is identified by the name LITERALS* on the assembly listing. COMPASS always assigns storage to 
the literals block immediately following the zero block. There is no ECS/LCM literals block. 


3.1.4 USER-ESTABLISHED LOCAL BLOCKS 

By using USE and USELCM statements, a programmer can establish local blocics in addition to those 
previously described for an absolute or relocatable subprogram. At the end of assembly, COMPASS assigns 
an origin relative to the nominal block to each user-established local block, in the sequence in which they 
are established. 

All of the CM/SCM local blocks are concatenated to form a single block, which is treated by the loader as 
a CM/SCM block whose name is unique to the subprogram. Similarly, all of the ECS/LCM local bloci<s are 
concatenated to form a single block which is treated by the loader as an ECS/LCM block whose name is 
unique to the subprogram. (SCOPE 2 does not currently allow LCM local blocks.) 

The length of each ECS/LCM block, including the combined local block, is rounded up, if necessary, to an 
integral multiple of eight 60-bit words. The maximum size of an ECS/LCM block is 1,048,568 words. 


3.1.5 LABELED COMMON BLOCKS 

A labeled common block is a storage area that can be preset with data accessible to one or more 
relocatable subprograms. These blocks are designated during assembly as being in CM/SCM or ECS/LCM 
through the USE and USELCM pseudo instructions respectively, where the name of the block is the name 
enclosed by slashes; that is, /name/- The tables are designed so that the loader can allocate space in 
memory for the first subprogram that is loaded that declares the block- Thus, the first subprogram that 
names a block sets the maximum size of the block. Each subprogram, as it is loaded, can link to allocated 
blocks or can cause new blocks to be allocated. The contents of a labeled common block can be generated 
by any of the subprograms having access to it. 
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If an absolute subprogram attempts to establish a labeled common block by using a USE /name/ or USELCM 
/name/ pseudo instruction, COMPASS treats the block as a local block having the slash-enclosed name* 


3.1.6 BLANK COMMON BLOCKS 

A blank common block is a storage area that cannot be preset with data. That is, the loader does not load 
information into the area before the program is executed. 

For a relocatable program, the CM/SCM and ECS/LCM blank common blocks are allocated space by the 
loader after all subprograms are loaded, according to the largest block area declared by any of the 
subprograms. A CM/SCM blank common block is established through use of the USE pseudo instruction 
(chapter 4). An ECS/LCM blank common block is established through use of the USELCM pseudo 
instruction (chapter 4). A blank common block has no name, A USE // indicates blank common in 
CM/SCM; A USELCM // indicates blank common in ECS/LCM. 

If no relocatable program declares a blank common block, there is none. If on absolute program contains a 
USE // or USELCM // pseudo instruction, COMPASS treats the block as a local block named // and data can 
be stored in this block. 

The USELCM pseudo instruction can occur only in CPU programs. 


3.1,7 REDUNDANT BLOCK NAMES 

A CPU subprogram may have two blocks with the same name and the same memory type if they have 
different block types (local or common). Furthermore, a CPU subprogram may have two blocks with the 
same name and the same block type if they have different memory types (CM/SCM or ECS/LCM). Thus, 
altogether, there may be up to four different blocks with the same name. 


3.2 BLOCK CONTROL COUNTERS 

For each block used in a subprogram, COMPASS maintains three counters: an origin counter, a location 
counter, and a position counter. When a block is first established or its use is resumed, COMPASS uses the 
counters for that block. During pass one, the origin and location counters are initially zero. During pass 
two, as the assembler constructs the program, it assigns an initial value to each local block origin counter 
and location counter. Thus, expressions containing relocatable symbols are not necessarily evaluated the 
same in pass one and pass two. 


3.2.1 ORIGIN COUNTER 

The origin counter controls the relative location of the next word to be assembled or reserved in the block- 
It is possible to reserve blank storage areas simply by using either the ORG, ORGC, or BSS pseudo 
instructions to advance the origin counter; ORG and ORGC also permit the programmer to reset the 
counter to some lower location in the block or to change blocks- BSS allows the programmer to decrement 
the counter but not to change blocks. The origin counter is incremented by one for each word assembled or 
skipped forward. The origin counter is decremented by one for each word skipped in the reverse direction. 

When the special element *0 is used in an expression, the assembler replaces it by the current value of the 
origin counter for the block in use. 
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3.2.2 LOCATION COUNTER 


The location counter is normally the same value as the origin counter and is used by the assembler for 
defining symbolic addresses witliin the block. The counter is incremented whenever the origin counter is 
incremented. It is possible through the LOG pseudo instruction to adjust the location counter so that it 
differs from the origin counter. This may be desirable when the code being assembled is to be loaded at 
one location and subsequently moved and executed at another location. In this case, the programmer resets 
the location counter to reflect the actual location at which execution is to occur. As another example of 
its use, the programmer assembling alEirge table may reset the location counter to zero so that on the 
listing, the addresses alongside each word of the table reflect the word^s position in the table rather than in 
the block. Note that use of this teclinique does not alter the placement of code in the block. (For an 
example of these applications, see the LOG pseudo instruction in chapter 4) When either of the special 

elements * or *L is used in an expression, the assembler replaces it by the current value of the location 
counter for the block in use. 


3.2.3 POSITION COUNTER 

■ Assume that bits are numbered 59 through 00, from left to right witliin a 60-bit GPU word, and numbered 
11 through 00 within a 12-bit PPU word, and numbered 15 through 00 within a 16-bit PPU word. Then, the 
position counter is initially 60, 16 or 12, respectively, and indicates the number of bits remaining in the 
word. The position counter, which is decremented by one for each completed bit of an assembled word, 

I becomes 00 when the word is completed, and is reset to 60, 16 or 12 when a new operation is started. 

For a CPU assembly, the 15-bit and 30-bit CPU instructions cause the position counter to normally have 
values of 60, 45, 30, and 15 reflecting the placement in the word for the next instruction or data value to 

■ be generated. For a PPU assembly, the normal value is 12 (16 if GIPPU is specified and the long 
instruction format is used). 

The normal pattern of advancement for the position counter can be altered through use of the VFD and 
POS pseudo instructions. 

When the special element *P is used in an expression, the assembler replaces it with the current value of 
the position counter. 

When the specif element $ is used in an expression, the assembler replaces it with the current value minus 
one of the position counter for the block in isej that is, it returns the next available bit position. 


3.2.4 FORCING UPPER 

In a CPU assembly, if any of the following conditions is true, the assembler packs parcels remaining in a 
partially completed word with no-operation instructions (section 8.1), sets the position counter to 60, and 
increments the origin and location counters before it assembles code for the next instruction: 

Insufficient room remains in a partially filled word for the next instruction or data to be generated. 

The current statement is a machine instruction, or a VFD pseudo instruction, with a location symbol or 
+ in the location field. 

The current statement is an RE, WE, PS, XJ, CC, CU, DM, or IM (or RL or WL on NOS and NOS/BE) 
Instiuction for a CYBER 180 Series, a CYBER 170 Series, CYBER 70/Model 71, 72, 73, 74, or 6000 
Series. (The programmer can negate this force upper by placing a minus sign in the location field of 
the instruction.) 

The current statement is an END, BSS, BSSZ, DATA, DIS, CON, SEGMENT, SEG, IDENT, ORGC, LOU, 
ORG, or MD pseudo instruction. 
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The assembler forces upper after it assembles code for one of the following: 


JP 

RJ 

Unconditional EQ 
Unconditional ZR 
ES (CYBER 70 Model 76 or 7600) 

MJ (CYBER 70 Model 76 or 7600) 

PS (CYBER 180 Series, CYBER 170 Series, CYBER 70 Model 71, 72, 73, 74, or 6000 Series) 

XJ (CYBER 180 Series, CYBER 170 Series, CYBER 70 Model 71, 72, 73, 74, or 6000 Series) 

IM (CYBER 70 Model 72 and 73) 

This post force upper does not occur immediately, but is deferred until the assembler encounters the next 
machine instruction or data generating, storage allocating, or binary control pseudo instruction in the same 
USE block. The programmer can negate the force upper following the instruction by placing a minus sign in 
the location field of the next instruction. Thus, pseudo instructions following one of the above machine 
instructions and referencing the origin, location, or position counter will use the value before the force 
upper. 

In a PPU assembly, no forcing upper occurs; the assembler ignores a + in the location field on any 
instruction other than a VFD. A plus or minus in the location field of a VED in PPU assemblies forces the 
VFD data to begin at the next full word. 


3.3 RELOCATABLE PROGRAM STRUCTURE 

A CPU relocatable program consists of one or more subprograms that can be assembled separately, either 
in the same job run or in independent runs. The subprograms can all be written in COMPASS source 
language, or can be written in any other source language available in the product set of the operating 
system as long as the compile- or assembler produces relocatable binary output in a form acceptable to the 
loader. A COMPASS language subprogram is composed of instructions beginning with an IDE NT pseudo 
instruction and ending with an END pseudo instruction. A subprogram can be either a main program or a 
subroutine, depending on how its END pseudo instruction has been written. 

When a program is loaded into memory, its subprograms occupy contiguous blocks of words. The first word 
in the first block is known as the reference address (RA). The total number of words in the blocks is the 
job field length. 

When a subprogram is relocated, each machine instruction in it that references a specific address must be 
adjusted. Because of this necessity, r^ocatable subprograms are assembled as though they begin at address 
zero; they are not assigned specific origins. In this way the loader can load subprograms independently, yet 
contiguously; their origins are relative to RA. Since all addresses within the subprogram are relative to the 
first word address of the subprogram, each address in the program effectively becomes a function of RA. 

A nonblank IDENT pseudo instruction that does not specify a fixed load address indicates a relocatable 
subprogram. Upon completing assembly of a relocatable subprogram, COMPASS assigns each local block an 
origin relative to the zero block. Each block thus becomes an extension of the zero block (figure 3-1). 

COMPASS also provides for subprogram linkage. Through pseudo instructions such as ENTRY, ENTRYC, 
and EXT, subprograms can transfer control to each other and access common storage locations. 

The loader is thus able to load subprogram blocks independently, as required. Program execution is not 
affected by the relocation process. 

The length of the subprogram given on the assembly listing is the sum of the final values of the origin 
counters for the local blocks, including the zero block and literals block, but not the absolute block. Any 
absolute text is simply inserted at the absolute location relative to RA. 

COMPASS binary output for a relocatable subprogram consists of one section for each LCC pseudo 
instruction (if any) in the source program, followed by one section containing the subprogram loader tables. 
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Figure 3-1. Relocatable Program Structure 


3.4 ABSOLUTE PROGRAM STRUCTURE 

An absolute program consists of code that is not relocatable and must be loaded at specific memory 
locations. Because the loader performs no address manipulation for absolute programs, absolute code can 
be loaded more rapidly than relocatable code. 

A CPU program can be either relocatable or absolute. PPU programs are always absolute. PPU programs 
are parts of the operating system that reside in the peripheral processors; they are normally the concern of 
only system analysts. Any user can assemble PPU code, but cannot execute it without special system 
access privilege. 

The programmer has the option of constructing an absolute program as a single unit, or of dividing it into 
overlays. Each overlay consists of data, information, or instructions that are needed at different times. 
Dividing a program into overlays allows several routines to occupy the same central memory storage 
consecutively so that total storage requirements for a program are reduced. For maximum program 
efficiency, the reduction of storage requirements must be weighed against an increase in execution delay 
while loading parts of the program. 

During assembly of an absolute program or overlay, COMPASS creates a memory image of the absolute 
code. During pass two, it assigns each block an origin relative to the absolute Dlock. Any relocatable 
symbol is reassigned an absolute address; each block effectively becomes an extension of the absolute block. 

Figure 3-2 illustrates the structure of an absolute program that is not divided into overlays. The absolute 
block is the nominal block for the program (labeled PROGRAM* on the listing). The use of default symbols 
and literals causes the generation of the zero block and the literals block, respectively. Local blocks A, B, 
and C follow the literals block. The transfer symbol in the END pseudo instruction indicates a main 
subprogram. In the binary load module the'prefix (PRFX or 77000) table and the header table precede 
the binary section that is the memory image of the program. 


3-6 


60492600 G 




IDENT name—- 

PROGRAM^ 


A 


B 


C 

END trasym—►- 

Source Program 
Block Structure 


Origin- 


Binary 

Section 





Program 
Identification 
and Loader Control 
Information 


Zero Block 
(Default) 


Binary 
Load Module 


Low Address 


High Address 


Origin 



} 


Zero Block 
(Default) 


Map of 

Loaded Program 


Figure 3-2. Absolute Program Structure 
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The binary output for the program consists of a section for each overlay. Note that the binary section for 
an absolute program that is not divided into overlays has the same format as the main overlay of a program 
divided into overlays. The user has the option of writing part of a binary section at a time by using either a 
SEG pseudo instruction or an ID ENT (other than the first IDENT) with a blank variable field. 

An absolute binary load module usually has three parts; a prefix (PRFX or 770 O 3 ) table, a header table, 
and the binary image of the program or overlay. A header table can be one of the following: 

ASCM or SOOOfi. 

EASCM or SlOOg. 

ACPM or 53003 . 

EACPM or 54003 . 

Tables are shown on a COMPASS listing by their octal numbers. The table formats are described in the 
Loader reference manual. 

The amount of binary written as a result of the binary control instruction (IDENT, SEGMENT, SET, or END) 
is subject to whether or not an entire block group is written, as follows: 

If a complete block group is being written (everything between an IDENT eind an END or between two 
IDENT instructions), the memory image of the program or overlay ends with the maximum origin 
counter value for the last block established, that is, with the last word address. 

If only a portion of the binary for the block group is being written, it consists of the memory image of 
the program or overlay ending with the value of the current origin counter. 

END, SEGMENT, and a nonblank IDENT complete one overlay and write an end of section. SEGMENT and 
IDENT write header information for the overlay to follow. 


3.4.1 ABSOLUTE OVERLAYS 

When an absolute program contains more than the one IDENT*^’ pseudo instruction or contains SEGMENT 
pseudo instructions, COMPASS does not prepare just one section of a memory image of the program as it is 
assembled, but, instead, generates a section for each overlay. 

Dividing the program into overlays permits memory to be sequentially overlaid by different subroutines and 
data during program execution, reducing the maximum memory requirements for the program. 

Three levels of overlays can be generated for a CPU assembly; main, primary, and secondary. Each 
overlay is identified by a level number specified in the IDENT or SEGMENT pseudo instruction. The level 
number consists of an ordered pair of octal numbers, each of which can be 0 through 773 . The first 
number is known as the primary level number; the second is known as the secondary level number. The 
level number 0,0 signifies the main overlay (normally the portion of the program following the first 
IDENT). A primary overlay is indicated by a nonzero primary number paired with a zero secondary level 
number. For a secondary overlay both the primary and the secondary level numbers are nonzero. 

Conventionally, the main overlay is loaded first and remains in central memory throughout execution. Only 
two other overlays can remain loaded concurrently; these are usually one primary overlay and one of its 
associated secondary overlays. 


^IDENT instructions described in this section are assumed to have nonblank parameters. The special case 
of the blank IDENT is described in section 3.4.3. 
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The hierarchy of overlay association is depicted by figure 3-3. The prim ary, overlay 1,0 has three 
associated secondary overlays numbered 1,1; 1,2; and 1,3. A primary overlay and all of its associated 
secondaries have the same primary level number. The next branch of overlays (indicated by level 
numbers 77,y) shows that the level numbers of the overlays are not required to be consecutive nor to be 
indicative of the order in which they were generated. 



Secondary 

Overlays 


Primary 

Overlays 


Main 

Overlay 


Figure 3-3. Overlay Hierarchy 

The main overlay can caU both primary and secondary overlays into main memory via the operating system 
loader. (For detailed information concerning loader calls, see the Loader reference manual.) Once a 
primary overlay is loaded, it can caU any of its associated secondary overlays. Overlay 23,0, for example, 
can call overlays 23,10; 23,30; and 23,40 in any order. 

The main overlay can have multiple entry points: execution can begin at any one of them. Usually, 
primary and secondary overlays have a single entry point which provides the transfer address. A secondary 
overlay can reference entry points in its primary and in the main overlay. A primary overlay can reference 
entry points in the main overlay. The programmer must ensure that the necessary entry points have not 
been overwritten. 

These conventions concerning the numbering, hierarchy, loading, and execution of overlays are not 
enforced by COMPASS, Any overlay can call the operating system loader to load another overlay, and any 
overlay can reference addresses in any other overlay. However, overlays are not all in central memory 
during program execution and the sequence in which the overlays are loaded and executed is beyond the 
scope of the assembler; therefore, it is the user^s responsibility to assure that an overlay does not refer to 
symbols, instructions, or data not concurrently in central memory. 

Although PPU overlays are not identified by level numbers, they resemble CPU overlays in all other 
respects. However, a PPU overlay with assembled code in locations 7774b through 7777b 1°^*^ 

incorrectly due to wraparound to location 0000. 

Overlays generated by using ID ENT pseudo instructions differ in certain respects from overlays generated 
by using SEGMENT instructions, as described below. 

Binary formats for overlays are described in the Loader reference manual. 
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IDENT-Type Overlays 

An IDENT-type overlay consists of the portions of the program from: 

One IDENT to (but not including) the next IDENT 
The last roENT in the overlay to the END 

IDENT provides the programmer with the option of specifying the overlay level numbers with each 
overlay* The assignment of unique level numbers enables the loader to locate a specified overlay among 
overlays written on the same file. If the programmer does not specify level numbers for a CPU assembly, 
COMPASS assigns numbers 0,0 to the first overlay, and numbers 1,0 to all subsequent overlays. 

The first IDENT causes COMPASS to generate the program or overlay identification information that 
precedes the absolute section. Upon encountering a second IDENT instruction before an END instruction, 
COMPASS generates output consisting of a memory image of the overlay, starting with the overlay origin 
specified on the previous IDENT and normally ending with the maximum origin counter value of the last 
block declared in the overlay; that is, the overlay normally ends with the last word address of its last 
block. An IDENT subsequent to a SEG or SEGMENT, however, generates binary that ends at the location 
specified by the current origin counter. Following the memory image, COMPASS writes an end'-of-section 
(or end“Of-record) and the overlay identification information specified by the new IDENT for the overlay to 
follow. 

For an IDENT-type overlay, COMPASS completes all blocics, including the literals block. Block structuring 
starts fresh with each overlay. This means that each overlay cam use the same block names used by other 
overlays, and each overlay can contain a literals block. The USE table and control counters are aill 
reinitialized. The origin specified for an IDENT-type overlay can be any place in a previously generated 
overlay. This is possible because IDENT causes the assembler to assign an absolute address to each symbol 
in the symbol table. It can do this because the sizes of all the blocks are known. 

Figure 3-4 illustrates a CPU program in which a second IDENT is used prior to an END pseudo instruction 
to generate a main overlay and a primary overlay. Between the two IDENT instructions, block usage 
alternates between the absolute block (labeled PROGRAM* on the listing) and block A, as depicted in the 
block structure diagram- Note that in the main overlay (the first section of binary generated, labeled 
MAIN), the assembler has concatenated the portions of each block. Concatenation also occurs in the 
primary overlay, OVl, for the portions of the absolute block ABSOLUTE^ and for those of blocks A^ B, 
and C« 

The occurrence of literals and default symbols causes the assembler to generate a zero block and a literals 
block, respectively, in both of these overlays. Following the second nonblank IDENT, the program overlay 
origin is set back into block A, as shown in the map of the two loaded overlays. Note that the loader 
control table is loaded in memory below the address specified in the ORG pseudo instruction (BETA, in the 
figure), as shown in the map of the loaded overlays. 

The first IDENT pseudo instruction assigns the level number 0,0 to the first overlay (MAIN). COMPASS 
assigns level number 1,0 to overlay OVl by default. 


SEGMENT-Type Overlays 

A SEGMENT-type overlay consists of the portions of a program from: 

The IDENT that identifies the program to a SEGMENT pseudo instruction 

One SEGMENT to the next SEGMENT 

The last SEGMENT to the END pseudo instruction 


3-10 


60492600 G 




IDENT MAIN.0,0- 
BETA- 


IDENTOVl 
ORG BETA 




END- 


ABSOLUTE 


ABSOLUTE 


ABSOLUTE 


A’ 


ABSOLUTE' 


ABSOLUTE' 


B 


A' 


MAIN origin 


BETA- 










iSS Prefix Table iS 


S Loader Controlji; 
Misinformation:::::::: 


ABSOLUTE 


ZERO 


LITERALS 


MAIN overlay 

0,0 






First Binary 
Load Module 


\ 




X 




OVl origin- 


\ 


Source Program \ 
Block Structure 


\ 


\ 


•: Loader Control ::j 
MM Information 


Overlaid portion ) 
of MAIN overlay I 


ABSOLUTE 


Loader Control ji 
MS Inf or m at ion iMS 


ABSOLUTE' 


ZERO' 


LITERALS' 


A' 


Low 


\ 


Addres^ 


OVl 

1.0 


\ 


\ 


\ 


\ 


\ 


\ 


\ 


MS Prefix Table MS 


?: Loader Control j: 
MM m ation SSj: 


ABSOLUTE' 


ZERO' 


LITERALS' 


A' 


OVl overlay 

1.0 


Second Binary 
Load Module 


t 

High Address 


Map of Loaded 
Overlays 


Figure 3-4. IDENT-Type Overlay Structure 
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SEGMENT provides the programmer with the option of specifying the overlay level numbers with each 
overlay* The assignment of unique level numbers enables the loader to locate a specified overlay among 
overlays written on the same file. If the programmer does not specify level numbers for a CPU assembly, 
COMPASS assigns numbers 0,0 to the first overlay, and numbers 1,0 to all subsequent overlays. 

Upon encountering a SEGMENT instruction, COMPASS generates output consisting of a memory image of 
the overlay starting with the overlay origin specified on the previous SEGMENT (or IDENT, for the first 
overlay), and ending with the current origin counter value of the block in use at the time the SEGMENT 
was encountered. Following this, COMPASS writes an end-of-section and overlay identification 
information for the overlay to follow. 

SEGMENT does not clear the symbol table or reinitialize the USE table. Thus, when a SEGMENT is 
encountered, the block in use is incomplete. It is the responsibility of the user to assure that all blocks 
other than the one in use are complete at that time. Also, the only symbols that can be used to define the 
origin of the new overlay are those valid for the block in use. 

Each new SEGMENT-created overlay must use unique block names because blocks established in previous 
overlays cannot be resumed and because the block names remain in the USE table due to the 
incompleteness of the block group. 

Figure 3-5 illustrates a program consisting of a main overlay, MAIN, and a primary, OVi. The use of 
default symbols causes generation of a zero block. The use of literals causes generation of a literals 
block* Both of these blocks occur in the overlay MAIN, because it contains the end of the absolute block. 
Block A begins in the main overlay, but is incomplete when COMPASS encounters the SEGMENT. The 
ORG pseudo instruction causes the origin of the primary overlay OVI, to be set at load time to TAG, at a 
lower address in block A. (Note that the loader control information is loaded at an address lower than the 
origin of the overlay.) OVI establishes new blocks C and D. 


3.4.2 MULTIPLE ENTRY POINT OVERLAYS 

When a CPU program or overlay that calls an overlay is assembled independently of the overlay called, it 
may be desirable for the called overlay to identify more than one entry point. Thus, ENTRY pseudo 
instructions are permitted within an absolute assembly and cause the generation of a SlOOg overlay 
table. This table consists of a control word and a list of overlay entry points. The calling program can 
examine the list and link to any of the entry points. The SlOOg table occupies the area below the overlay 
origin and uses one more word than the number of entries in the table. For the format of the 5100g 
table, refer to the Loader reference manual. 


3.4.3 PARTIAL BINARY 

When a CPU absolute program or overlay contains SEG pseudo instructions or IDENT pseudo instructions for 
which the parameters are omitted (blank), COMPASS writes a partial binary section consisting of the 
binsu'y generated since the previous IDENT, SEGMENT, or SEG instruction. However, it does not write an 
end-of-section (or end-of-record) or a new prefix table. A SEGMENT, nonblank IDENT, or END instruction 
completes the binary section. 


SEG Partial Binary Record 

By writing partial binary records using SEG, the programmer can reduce the assembler storage 
requirements. SEG does not write a complete block group. When the SEG is encountered, COMPASS writes 
binary beginning with the first block established in that portion of binary and ending with the final count 
specified by the origin count for the current block. A fatal error is issued if the user attempts to store 
data into a block not in the current partial binary record. 

The portion of the binary that contains the end of the absolute block contains the literals block, if there is 
one. The symbol table and USE table are not reinitialized. 
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Figure 3-5. SEGMENT-Type Overlay Structure 
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Figure 3-6 illustrates how the binary for an absolute program can be written in three separate binary 
writes to reduce the amount of memory required to assemble the program* The resulting absolute section 
is loaded and executed as a single program or overlay. 
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Figure 3-6. SEG Partial Binary 


IDENT Partial Binary 

An IDENT with a blank variable field causes all binary accumulated since the previous IDENT, SEG, or 
SEGMENT to be written out without an end-of-section (or end-of-record) or a new TTOOg prefix table. 

The USE table and the block counters are reinitialized. Each symbol in the symbol table is assigned an 
absolute address. The blocks in each partial binary section generated in this manner are allocated as if the 
partial binary section were a new subprogram with its own absolute block, literals block, and local blocks. 
This allows portions of a program to be self-contained units even though they are not overlays but are 
loaded as a single unit. The origin of an absolute block for new portion is the last word address plus one of 
the last block of the previous portion. 

The core image written by a blank IDENT starts with the origin of the absolute block and normally ends 
with the maximum origin counter value of the last block declared in the block group; that is, it normally 
ends with the last word address. If part of the block group has already been written by a SEG or 
SEGMENT, however, the end of the binary is specified by the value of the origin counter for the current 
block. 

COMPASS completes all blocks. The literals block is terminated. Block structuring starts fresh with each 
IDENT. Each new partial binary section created by a blank IDENT can use the same block names as are 
used by the other blank ID ENT-created partial binary sections and non-blank IDENT-created overlays and 
each IDENT can contain a literals block but the blocks with the same names are independent of each other. 

An attempt to write into or to reset the origin counter to a location in a partial binary section written 
separately causes an assembler range error. 
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Figure 3-7 illustrates how the binary for an overlay can be written in three discrete partial binary sections 
to reduce the amount of central memory required to assemble the program and divide the program into 
self-contained units. The resulting absolute section is loaded and executed as a single overlay. 
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Figure 3-7. IDENT Partial Binary Records 
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PSEUDO INSTRUCTIONS 


4 


4.1 INTRODUCTION TO PSEUDO INSTRUCTIONS 

The format of the COMPASS pseudo instruction is the same as that of the symbolic machine instruction; it 
includes the location field, the operation field, the variable field, and the comments field. The pseudo 
instruction differs from the symbolic machine instruction in that it is used to control the actions of the 
assembler at assembly time, rather than those of the machine at execution time. 

The pseudo instructions avatlahle in the COMPASS language are presented in this chapter and in chapters 5, 
6, and 7. Programmers with little COMPASS experience should give special attention to a few important 
pseudo instruction^, which are listed in the followin^tahle. It is not possible to write a COMPASS program 
without using some of them. The table indicates the type of assemblies in which the pseudo instructions 
can be used. 


Pseudo Instruction 

Section CPU Relocatable 

CPU Absolute 

PPU Absolute 

IDENT 

4. 2.1 

X 

X 

X 

ABS 

4. 3.1 

- 

X 

_ 

PPU or PERIPH 

4.3.3 or 4.3.4 

- 

- 

X 

ORG 

4. 5.3 

X 

X 

X 

ENTRY 

4.7.1 

X 

- 

- 

BSS 

- 4. 5. 4 

X 

X 

X 

CON 

4. 8.6 

X 

X 

X 

END 

4 .2.2 

X 

X 

X 


4.1.1 TYPES OF PSEUDO INSTRUCTIONS 

Pseudo instructions discussed in this chapter are classed according to application as follows: 

Subprogram identification (IDENT and END) 

Binary control (ABS, MACHINE, PERIPH, PPU, CIPPU, IDENT, SEGMENT, SEG, LCC, MEMSEL, 
LDSET, STEXt, COMMENT, and NOLABEL) 

Mode control (BASE, CHAR, CODE, COL, Bl=l, B7=l, and QUAL) 

Block counter control (USE, USELCM, ORG, ORGC, BSS, LOC, and POS) 

Symbol definition (EQD and =, SET, MAX, MIN, MICCNT, andSST) 

Subprogram linkage (ENTRY, ENTRYC, and EXT) 

Data generation (BSSZ and blank operation code, DATA, DIS, LIT, VFD, CON, R=, REP, REPC, and 
REP I) 

Assembly control (ELSE, ENDIF, IFtype, IFop, IF, IFC, IFPL, IFMI, and SIHP) 

Error control (ERR md ERRxx) 

Listing control (LIST, EJECT, SPACE, TITLE, TTL, NOREF, CTEXT, ENDX, and XREF) 
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Later chapters describe pseudo instructions that involve definition operations, alterations to the operation 
code table, and micros. In general, pseudo instructions can be summarized according to where they can be 
placed in a subprogram, 


4.1.2 REQUIRED PSEUDO INSTRUCTIONS 

Two pseudo instructions, IDE NT and END, are required for any assembly. IDE NT must be the first source 
statement; END signals the termination of source statements for a subprogram. 


4.1.3 FIRST STATEMENT GROUP 

Certain pseudo instructions establish basic characteristics of the assembly and provide the assembler with 
required information. These instructions make up the first statement group which must precede any 
symbol definition, storage allocation, or object code generation. The following instructions, if used, mist 
be in the first statement group: 

ABS 

MACHINE 

PERIPH 

PPU 

appu 

STEXT 

MEMSEL 


4.1.4 PERMISSIBLE ANYWHERE INSTRUCTIONS 

The following pseudo instructions are permissible anywhere, indudingin the first statement group: 


BASE 

XPSYN 

ENDM 

MACROE 

OPDEF 

SKIP 

Bl=l 

DECMIC 

HERE 

MICCNT 

OPSYN 

SPACE 

B7=l 

EJECT 

TEC 

MICRO 

PPOP 

SST 

CHAR 

ELSE 

IRP 

NIL 

PURGDEF 

TITLE 

CODE 

END 

LDSET 

NOLABEt 

PURGMAC 

TTL 

COMMENT 

ENDD 

LIST 

NOREF 

QUAL 

XREF 

CPOP 

ENDIF 

MACRO 

OCT MIC 

RMT 



Comment lines and references to macro definitions are also permitted anywhere. 

CPU OP PPU symbolic machine instructions and all other pseudo irstructions cannot be placed in the first 
statement group. The first use of one of these instructions terminate the first statement group. 


4.2 SUBPROGRAM IDENTIFICATION 

Subprogram identification pseudo instructions designate subprogram beginning and end. When two or more 
subprograms are assembled in a single COMPASS run called through the COMPASS control statement, the 
end of the source decl<s is indicated by an end-of-section,such as a 7/8/9 card. 


4.2.1 IDENT-SUBPROGRAM IDENTIFICATION 

AnIDENT pseudo instruction of the following form is the first statement of a subprogram recognized by 
the assembler. Usually, any lines preceding the first IDENT or between an END and IDE NT are assumed to 
be comments. However, when COMPASS has been called by some other language processor such as 
FORTRAN, the assembler returns control to the processor when the statement following END is not 
IDENT. For a rdocatahle subprogram, COMPASS fla^ any subsequent iBe of IDENT before END as an 
error. For an absolute subprogram, a second form of IDENT described under BINARY CONTROL is 
available for overlay generation. 
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The format of IDENT varies according to the type of assembly. 
CPU Relocatable Format: 


LOCATION 

OPERATION 

variable SUBFIELOS 


IDENT 

name 


CPU Absolute Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


IDENT 

name, origin, entry, ij^ ,£ 2 


7600 PPU Absolute Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


IDENT 

name, origin, entry, ppu 


6000 Series PPU Absolute Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


IDENT 

name, origin 


name Name of the subprogram or overlay. The parameter is required. For a CPU relocatable 

or absolute assembly, name can be 1 through 7 characters, of which the first must be 
alphabetic (A through Z) and the last must not be a colon. 

For a CYBER 70/Model 76 or 7600 PPU assembly, name can be 1 through 7 characters. 
For CYBER 180 Series or CYBER 170 Series or CYBER 70/Model 72, 73, 74 or 6000 
Series PPU 12-bit assembly, name can be 1 through 3 characters. For CYBER 180 
Series PPU 16-bit assembly, name can be 1 through 4 characters. In any case, there is 
no restriction on the first character, but the last character must not be a colon. 

origin An expression specifying the first word address of the absolute program or overlay. The 

overlay loader table and all code assembled starting at this address and ending with the 
next SEGMENT, nonblank IDENT, or END instruction make up the overlay. For a single 
entry point CPU program, the load address for the overlay is origin-1. The word at 
origin-1 is overlaid by the SOOOg loader control table. For a multiple entry point CPU 
program, the load address for the absolute overlay is origin-wc-1, where wc is the 
number of entry points in the SlOOg loader table. 

For a PPU subprogram, the load address is origin-5. Five 12-bit PPU words are overlaid 
by the 60-bit loader table. 

Data can be generated in locations starting with origin and above, but not below origin. 
The origin subfield does not serve the same funtion as ORG, nor does it replace ORG 
for setting the origin counter. 
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If the origin field is null for an absolute subprogram, the assembler uses address 
000000 RA(S) as the origin for a CPU program and 0000 as the origin for a PPU program. 

For a relocatable subprogram, the subfield is ignored. The loader automatically 
relocates the first subprogram to be loaded starting at RA(S)+ 1003 , the second 
subprogram starting at the first available location following the first subprogram, and so 
forth. 

entry For a CYBER 70/Model 76 or 7600 PPU assembly or for an absolute CPU assembly, this 

subfield contains an expression specifying the subprogram entry address, which can be 
symbolic. 

,^2 Absolute expressions specifying the level numbers of the overlay. Hi is the primary 

level (0 through 63) and J&2 is the secondary level (O-GS). When the first IDENT 
identifies the main overlay, and ^2 t)e omitted. If is omitted, it is set 
to 00. If ^2 is omitted, it is set to 00. 

Because the first IDENT precedes any use of the BASE pseudo instruction, the level 
numbers on this IDENT are evaluated as decimal unless specifically designated as octal 
by a post radix. 

ppu Absolute expression specifying the number of the PPU on which this program is to be 

loaded. On the first IDENT, this number is evaluated as decimal unless specifically 
designated as octal. 

A location field symbol, if present, is ignored. 

If the COMPASS assembler is called from within a FORTRAN compilation rather than by a COMPASS 
control statement, IDENT must be in columns 11 through 15. 

When the subprogram does not include a TITLE instruction, COMPASS uses the IDENT variable field entry 
as the main subprogram title on the assembly listing. 

Example; 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

\ 


11 

18 |30 


CDN'TROL 

IHENT 

ARS 

ORG 

RSS 

FND 

CT,CONTROL,CONTROL 

lAnSOLUTE CPU PROOPAM 
ilQO 1 

0 pEFTNFS SYMPOL CQNTPOL 


Absolute CPU program CT will be loaded at origin address OOllOg. 


4.2.2 END-END OF SUBPROGRAM 

An END pseudo instruction must be the last instruction of each subprogram. It causes the assembler to 
terminate all counters, conditional assembly, macro generation, or code duplication. Before terminating 
assembly, COMPASS assembles any waiting remote text (see RMT). 
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For a relocatable subprogram, the assembler combines all local blocks into a relocatable subprogram 
block, generates the relocatable binary tables and produces the listing. 

For an absolute assembly, the assembler assigns each block an origin relative to absolute zero, 
combines all blocks into an absolute subprogram or overlay, generates the absolute binary section and 
produces the listing. 


END can also be used to signal the end of source statements from an external source (see XTEXT). In 
this case, it does not terminate the subprogram. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIOS 

sym 

END 

trasym 


sym Optional last word address symbol; if present, COMPASS defines it as the 

total subprogram length, including the literals block and all local blocks. 

The value is the last word address plus one. 

trasym A symbol specifying the entry point to which control transfers for a reloca¬ 

table subprogram. This symbol must be declared as an entry point in a 
subprogram — not necessarily the subprogram being assembled. At least 
one subprogram must specify a transfer address or the loader signals an 
error. If more than one subprogram indicates a transfer address, the loader 
uses the last one encountered. 

For an absolute assembly, trasym is ignored. 

Example: 
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4.3 BINARY CONTROL 


Pseudo instructions that allow the user extensive control of binary output produced by the assembler are 
summarized below and described fully in this section. 

ABS Specifies CPU absolute binary output 

MACHINE Specifies processor type 

PPU Specifies CYBER 70 Model 76 or 7600 PPU binary output 

PERIPH Specifies CYBER 180 Series; CYBER 170 Series; CYBER 70 Model 71, 72, 73, or 74; or 

1 6000 Series PP 12-bit binary output 

CIPPU Specifies CYBER 180 Series PP 16-bit binary output. 

IDENT Begins absolute overlay or writes partial binary section 

SEGMENT Begins absolute overlay 

SEG Writes partial binary section 

STE3Cr Generates system text overlay 

COMMENT Inserts comments into the 770 O 3 prefix table 
NOLABEL Suppresses header information on binary output 
LCC Passes loader control information to the relocatable loader 

LDSET Generates loader directive LDSET 

I MEMSEL CYBER 180 Series PP memory size selection. 

4.3.1 ABS - ABSOLUTE CPU PROGRAM 

An ABS instruction declares a CPU program to be absolute. If used, it must be in the first statement group. 

The following instructions are illegal in an absolute program: 

EXT 

LCC 

REP 

REPC 

REPI 

A symbol can be prefixed by =X if it is also defined conventionally; in this case, the =X has no significance 
because a conventional definition takes precedence (see Default Symbols in chapter 2). 

Eormat: 

LOCATION OPERATION VARIABLE 5UBFIEID5 

ABS 

Symbols in the location and variable fields, if present, are ignored. If a program contains both ABS and 
PERIPH (or PPU), the PERIPH (or PPU) instruction takes precedence. 
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Example: 



4.3.2 MACHINE - DECLARE OBJECT PROCESSOR TYPE 

The MACHINE pseudo instruction specifies the type of computer system on which the object program can 
be executed successfully and optionally specifies hardware features needed by the object program. When 
the loader loads the object program, the required hardware features specified with MACHINE are 
reconciled against actual hardware features present; a missing feature causes the loader to issue a fatal 
diagnostic message. If used, MACHINE must be in the first statement group. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBEIEIDS 


MACHINE 

type, hf^ , hfg, hfg, ..., hf^ 


A location field symbol, if present, is ignored. 

type Character string designating object processor type. The sub field can be any length and 

may contain any characters other than blank or comma. The first character identifies 
processor type, as follows: 

6 The object program is restricted to the following computer systems: CYBER 
180 Series; CYBER 170 Series; CYBER 70 Model 71, 72, 73, and 74; and 6000 
Series. All machine instructions unique to the CYBER 70 Model 76 or 7600 
Computer Systems are undefined. 

7 The object program is restricted to a CYBER 70 Model 76 Computer System or 
to a 7600 Computer System. With the exception of the PS instruction (often 
used for subroutine entry points in CPU assemblies), all instructions unique to 
the following computer systems are undefined: CYBER 180 Series; CYBER 
170 Series; CYBER 70 Models 71, 72, 73, and 74; and 6000 Series, 
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1 8 The object program is restricted to a model 810, 815, 825, 830, 835, 840, 845, 

850, 855, 860, 865, 875, or 990 Computer System. All machine instructions 
unique to other computer systems are undefined. This pseudo instruction 
should not be used if S=AIDTEXT has been specified on the COMPASS control 
statem ent. 

In a CPU assembly, if the MACHINE pseudo instruction is omitted, or the type subfield 
is blank, or its first character is not 6, 7, or 8, then all CPU instructions are defined, 
and the target and valid fields of the PRFX table in the object program are blanlo. If 
the type subfield is present and its first character is 6, 7, or 8, the valid field contains 
6 X, 7X, or 8X. If the type subfield is at least two characters, the first character is 6, 

7, or 8, and the second character is a digit (0-9), the target field contains those two 
characters. 

In a PP assembly, if the MACHINE pseudo instruction is omitted, or the type subfield is 
blank, or its first character is not 6, 7, or 8, then; if the PERIPH pseudo instruction is 
present, MACHINE 6 is assumed; if the PPU pseudo instruction is present, MACHINE 7 
I is assumed; if the CIPPU psuedo instruction is present, MACHINE 8 is assumed. The 

target field of the PRFX table contains blanks, and the valid field contains 6P, 7P, or 

8P. 

hfi Optional subfield, a character string designating an optional hardware feature required 

for successful execution of the object program. The subfield may be any length and 
may contain any characters other than blank or comma. It has no effect on assembly of 
the program. The first character of the subfield is placed in the 
hardware-instruction-dependencies fidd in the PRFX table in the object program. 

Recommended mnemonic letters are: 

C Compare/Move Unit 

D Distributive Data Path 

I Integer Multiply Instruction 

L ECS/LCM 

R Interlock Register 

X Central and Monitor Exchange Jumps 

Up to nine hfj subfields are processed; any additional subfields are ignored. If the 
hfi subfields are omitted, the comma following type can also be omitted. 


Example: 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

I 


M 

ts bo 



MACHINE 

6,CMU,LCH,x!j 

1 


4.3.3 PPU - CYBER 70 MODEL 76 OR 7600 PPU PROGRAM 

A PPU instruction declares a program to be a CYBER 70 Model 76 or 7600 absolute PPU program rather 
than a CPU program. If used, PPU must be in the first statement group. For a description of binary 
format generated as a result of this instruction, refer to the Loader reference manual. 
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Floating point constants and the following instructions are illegal in a PPU assembly: 


ENTRY 

SEGMENT 

ENTRYC 

USELCM 

EXT 

R= 

LCC 

Bl=l 

REP 

B7-1 

REPC 


REPI 


SEG 



A symbol can be prefixed by = X If It is also defined conventionally. 

If the program contains both a PPU and a PERIPH pseudo instruction, the PPU takes precedence. 

PPU programs permit symbols of the form used for CPU register designators; they are normal symbols 
having no special significance. The following instructions are legal but are not applicable in a PPU 
assembly; 

OPDEF 

CPOP 

CPSYN 

PURGDEF 

Format: 


lOCATION 

OPERATION 

VARIABLE SUBFiElDS 


PPU 

J 


J A character string beginning with J supplied in the variable field alters the way 

that COMPASS assembles the variable expression on UJN, ZJN, NJN, MJN, or 
PtTN instructions. 

If J is not specified, COMPASS first tests the range of the exi^ression against 
the short jump limit ttSl). If the value is in range, COMPASS assembles the 
jump using the value of the expression. Tf the value is out of range, COI\IPASS 
performs a second test, tliis time using the exjDression value minus the 
location counter value, tf the value is now in i^ange, COMPASS assemlDles the 
instruction using the expression value minus die location counter value. 
However, if it is out of range, a fatal error is flagged. 

Selection of the J option causes COMPASS to always subtract the value of the 
location counter from the value of the expression. 

As a result, COMPASS is able to differentiate between an exiiression value 
that is an absolute address in the short jump range from an expression value 
that is a true relative address. 

A symbol in the location field, if present, is ignored. 
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Example: 


Location Code Generated 


740 

760 0357 


Location Code Generated 


740 

760 0357 


[ 

LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

D 


11 

18 

ho 





1 


PPU 

« 


-1- 

1 


TAG 

m 

BSS 

UJN 


1 

1 

[EXPRESSION < 378 

1 


1 

LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


n 

18 

ho 







PPU 

• 

JUMP 

1 

1 

1 


TAG 

• 

RSS 

UJN 

2DR 

TAG 

1 

1 

[EXPRESSION-* < 370 


4.3.4 PERIPH - CYBER 180 SERIES; CYBER 170 SERIES; CYBER 70 
I MODELS 72, 73, 74; OR 6000 SERIES PPU 12-BIT PROGRAM 

A PEEIPH instruction declares a program to be a CYBER 180 Series or a CYBER 170 Series or CYBER 70 
Model 72, 73, 74, or 6000 Series absolute PPU program rather than a CPU program. If used, PERIPH must 
be in the first statement group. For a deseripton of binary output produced as a result of this instruction, 
refer to the Loader Reference Manual. 

Floating point constants and the following instructions are illegal in a PPU assembly; 

ENTRY LCC REPI R= 

ENTRYC REP SEG Bl=l 

EXT REPC USELCM B7=l 

I A symbol can be prefixed by =X if it is also defined conventionally. In this case, the X will be ignored. 

PPU programs permit symbols of the form used for CPU register designators; they are normal symbols 
having no special significance. The following instructions are legal but are not applicable to PPU 
assemblies: 

OPDEF 

CPOP 

CPSYN 

PURGDEF 

Format: 


LOCATION 

OPERATION 

VARIABLE SUDFIELDS 


PERIPH 

J 


J A character string beginning with J supplied in the variable field alters the way that 

COMPASS assembles the variable field expression on UJN, ZJN, MJN, or PJN 
instructions. 
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If J is not specified, COMPASS first tests the range of the expression value against the 
short jump limit (+31)* If the value is in range, COMPASS assembles the jump using the 
value of the expression. If the value is out of range, COMPASS performs a second test, 
this time using the expression value minus the location counter value. If the value is 
now in range, COMPASS assembles the instruction using the expression value minus the 
location counter value. However, if it is out of range, a fatal error is flagged. 

Selection of the J option causes COMPASS to always subtract the value of the location 
counter from the vfidue of the expression. 

For an example illustrating how to use J, see the PPU pseudo instruction. 

A symbol in the location field, if present, is ignored. 


4.3.5 CIPPU - CYBER 180 SERIES PPU 16~BIT PROGRAM 

A CIPPU instruction declares a program to be a CYBER 180 Series absolute PPU lO^-bit program, rather, 
than a CPU program. This instruction is required to allow use of the ”Long*^ or 16-bit wide PPU instruction 
set and to allow selection of PPU memory size (MEMSEL) greater than 4. If used, CIPPU must be in the 
first statement group. 

Floating point contents and the following instructions are illegal in a PPU assembly: 


ENTRY LCC REPl R= 

ENTRYC REP SEG Bl=:l 

EXT REPC USELCM B7=l 

A symbol can be prefixed by =X if it is also defined conventionally. In this case, the X will be ignored. 

PPU programs permit symbols of the form used for CPU register designators; they are normal symbols 
having no special significance. The following instructions are legal but are not applicable to PPU 
assemblies: 

OPDEF 
CP OP 
CPSYN 
PURGDEF 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 


CIPPU 

J 


J A character string beginning with J supplied in the variable field alters the way that 

COMPASS assembles the variable field expression on UJN, ZJN, MJN, or PJN 
instructions. 
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If J is not specified, COMPASS first tests the range of the expression value against the 
short jump limit (+ 31), If the value is in range, COMPASS assembles the jump using the 
value of the expresaon. If the value is out of range, COMPASS performs a second test, 
this time using the expression value minus the location counter value. If the value is now 
in range, COMPASS assembles the instruction using the expression value minus the 
location counter value. However, if it is out of range, a fatal error is flagged. 

Selection of the J option causes COMPASS to always subtract the value of the location 
counter from the value of the expression. 

For an example illustraling how to use J, see the PPU pseudo instruction. 

A symbol in the location field, if present, is ignored. 


4.3.6 IDENT “ IDENTIFY AND GENERATE OVERLAY 

Two or more IDENT pseudo instructions are permitted in CPU absolute or PPU assemblies. Second and 
subsequent IDENT instructions having nonblank variable fields cause generation of overlays. IDENT differs 
from SEGMENT in the way it generates overlays. First, it allows the specification of overlay numbers. 
Second, the USE table and all block counters are reinitialized. The symbol tkble is not dearedj all symbols 
are reassigned absolute addresses relative to absolute zero. This, an ORG to a previoiBly defined symbol 
restarts the absolute block at the symbolic address. The third difference is that normally the end of the 
overlay is determined by the last word address, the maximum origin counter value of the last block 
established in the overlay. A preceding SEG or SEGMENT can alter this, however (Section 3,4). 

For a CPU assembly, an IDENT with a blank variable field caises a partial binary write. The ouput is not 
terminated by an end-of-section or a new 77g table. However, the USE table and the block counters are 
reinitialized and each symbol in the symbol table is assigned an absolute address. 

Following an IDENT, COMPASS assumes that all blocks, including the literals block are complete. Block 
structuring starts fresh with the new overlay or portion of binary. Thus, each new overlay or partial can 
use the same block names as are iBed by other overlays or partial and each can have a literals block. 

For a blank IDENT, an attempt to write into or reset the ori^n counter to a location in a partial section 
written separately caiBes a range error. Following the IDENT, the ori^n of the new absoalute block is the 
next word after the binary written out, that is, it is lwa+1. 

The format of the IDENT varies according to the type of assembly as follows: 

CPU Absolute Format: 


LOCATION 

OPERATION 

VARIABLE SUBfIELDS 


IDENT 

name, origin, entry, . f g 
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or 


LOCATION 

OPERATION 

VARIABLE SUBFIELD5 


IDENT 



7600 PPU Absolute Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


IDENT 

name, origin, entry, ppu 


6000 Series PPU Absolute Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


IDENT 

name, origin 


Name of the overlay. For a CPU program, 1-7 characters, the first of which must be 
alphabetic (A-Z); for CYBER 180 Series or CYBER 170 Series or a CYBER 70/Model 72, 
73, or 74, or a 6000 Series PPU program, 1-3 characters; for a CYBER 70/Model 76 or 
7600 PPU program, 1-7 characters. In all eases, the last character must not be a 
colon. A name is a loader linkage ^mbol required for overlays. 

An expression specifying the first word address of the overlay. The overlay control 
word and aH code assembled starting with this address and ending with the next 
SEGMENT, nonblank IDENT, or END instruction comprises the overlay. For a single 
entry point CPU program, the load address for the overlay is origin-1. The word at 
origin-1 is overlayed by the SOs loader table. For a multiple entry point CPU 
program, the load address for the overlay is origin-wc-l, where wc is the number of 
entry points listed in the 51g loader table. 

For a PPU subprogram, the load address is origin-5. Five 12-bit PPU words are 
overlayed by the 60-bit loader control table. Data can be generated in locations 
starting with origin and above, but not below origin. The origin sub field does not serve 
the same function as ORG nor does it replace ORG for setting the origin counter. The 
origin of an overlay can be below the origin specified on any other IDENT or SEGMENT. 

entry An expression specifying the overlay entry address. When the overlay is called, control 

optionally transfers to this address. 

f 1 , ^2 Absolute expressions specifying the level numbers of the overlay for CPU programs 

only, is the primary level (OO- 773 ), ^ ^^e secondary level ( 00 - 773 ). If 

base Is m, and ^2 assumed to be octal. If and are not specified, 
i X IS set to 01 and f 2 ^ set to 00. 


name 


origin 
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ppu 


An absolute expression specifying the number of the PPU in which the overlay 
is to be loaded- If base is M, ppu is assumed to be octal. 


A location field symbol, if present, is ignored- 


The binary is written on the file specified by the B parameter on the COMPASS control statement, 
dumps the last overlay or completes a partially written section. 


Examples; 


The following program uses IDENT for overlay creation. Symbols T.OVL, O.DMPl, etc. are 
defined on a system text overlay. 


Oi*M 


bMP 


lOCATION 


UBW2 


OPERATION 


II 


lOENT 
A0S 
BASE 
COHMENTl 
LIST 
SST 
ORG 
OUAL 
SXO 


QUAL 

IDENT 

ORG 

SXO 


OUAL 

IDENT 

ORG 

SXO 


END 


VARIABLE 


COMMENTS 


IB 


30 




DHP,l,T.OVLfp.HHPl 
M 


10/07/70.C 


T.OVL 

OMPl 

B1 


ONTROL CARD CALL.DMP. 


OHPE 

DMP2,T.0VL,0 

T.OVL 

B6+1 


DHP9 

0HP.9fT.OVL, 
T.OVL 

0.0HP2+F.M0E 


.0MP2 


0.0MP9 


^ND 


OVERLAY 

DMPl 


OVERLAYS DHP2 
THROUGH DMPB 




OVERLAY 
DHPq 


OVERLAY DMP9 


END 
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The following program uses EDENT instructions having blank variable fields 


1617 


3455 


7116 



Origin”^ 

1617 

3455 ^ 

7116 ^ 

Iwa — 



Core Map 
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4,3,7 SEGMENT - GENERATE BINARY SEGMENT 


I 


The SEGMENT pseudo instruction produces overlays at assembly time. It has many of the features of 
IDENT and is included primarily to provide another way of handling literals. Use of SEGMENT is intended 
for 6000 Series CPU absolute or PPU assemblies. For a relocatable subprogram, a SEGMENT pseudo 
instruction causes BSSZ code and the FILL, REPL, and LINK relocatable tables to be written on the binary 
output file. 

The first SEGMENT causes all binary accumulated since the IDENT to be dump as the main (0, 0) overlay. 
Each subsequent SEGMENT generates a new overlay with the specified level numbers. END dumps the last 
overlay. When COMPASS encounters a SEGMENT pseudo instruction, it does not dear the symbol table or 
block declarations. All blocl<s other than the block in use must be complete. For a CPU assembly, the 
literals block must be in one overlay only but that overlay can be any overlay. 

Format: 


LOCAUON 

OPERATION 

VARIABLE SUBFIELDS 

name 

SEGMENT 

origin.entry.Jt^.ig 


name Name of overlay. For a CPU program, 1-7 characters, first of which must be 

alphabetic (A-Z); for a PPU subprogram, 1-3 characters. In all cases, the last character 
must not be a colon. It is a required loader linkage symbol. 

origin A relocatable expression specifying the first word address of the overlay. It can only an 

address in the block in use. The overlay loader table and all code assembled starting at 
this address and ending with the next SEGMENT, nonblank IDENT, or END instruction 
comprises the overlay. 

For a CPU program the load address for the record is origin-1. The word at origin-1 is 
overlayed by the SOgloader table. 

For a PPU subprogram, the load address is origin-5. Five 12-bit PPU words are 
overlayed by the 60-bit loader table. Data can be generated in locations starting with 
origin and above, but not below origin. The ori^n subfield does not serve the same 
function as ORG nor does it replace ORG for setting the origin counter. The origin of 
an overlay can be below the origin specified on any other IDENT or SEGMENT. 

entry An expression specifying the overlay entry address. It is used for CPU assemblies only. 

When the overlay is called, control optionally transfers to this address. 

Absolute expressions specifying the level numbers of the overlay for CPU programs 
only. is the primary level (OO-TTg), ^2 is the secondary level (00-77g}. If 
base is M, and J^2 assumed to be octal. If and are not specified, 

Xx is set to 01 and is set to 00, 
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Example: 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 



11 

IB 

|ao 



lOENT 

Ans 

SAM,FNTA 

-j- 



ORG 

lion 

1 


FNTfl 

PSS 

0 

ENTRY POINT 

1 



• 

■ 

m 

• 

1 


ovLor 

nss 

m 

n 

lOVFPLAY LCAO POINT 



• 

« 

1 



• 


1 


SEGl 

SFGMEM’ 

* STPT,ENTR 

1 



ORG 

OVLPr 

1 




1 

loader taple 


STPT 

P5S 

m 

n 

« 

[first word op overlay 

1 


ENin 

m 

P5S 

• 

a 

1 

EXECUTION HEGINS HERE 



« 

• 

1 

t 



« 

• 

1 



* 

« 






[end of OVFPLAV 


SEGl is loaded as an overlay upon a call for the loader from the program. The first word of the overlay is 
loaded at OVLOC+1, following the loader table. The entry point to the overlay and the first executable 
instruction is at ENTB. The overlay, when executed occupies the area of the main program beginning at 
OVLOC. 


I 4.3.8 SEG - WRITE PARTIAL BINARY 

The SEG pseudo instruction permits the generation of a CPU absolute subprogram or overlay in less core 
than would otherwise be required for assembly. It is illegal in PPU and relocatable assemblies. 

SEG causes COMPASS to write on the binary output file all binary information accumulated since the 
previous IDENT, SEGMENT, or SEG pseudo instruction. It does not write an end-of-section or begin a new 
PRFX table. A SEGMENT, IDENT, or END instruction completes the binary section. 

SEG does not affect the location and origin counters. The user cannot resume use of a block established 
prior to the SEG, except for the block in use when the SEG was encountered. An attempt to reset the 
ori^n counter so as to resume a block already written out causes an R error. Also, since the block group is 
incomplete and the names of the blocl<s already written out are still in the USE table, no new blocks can be 
established using the same block names as were used prior to the SEG. 

The literals block is written in the portion that contains the end of the absolute block. 
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Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


SEG 



Symbols in the location field and variable field, if present, are ignored. 
Example: 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


11 

IB ho 




1 .... 



IDENT 

NAME.ORIGINjENTRY 




1 



use 

* 1 



• 




« 

. 1 



• 

. 1 



SEG 




USE 

B 1 



• 

• 1 



• 




• 

. 1 



SEG 

1 



• 

. 1 



• 

1 



• 

• 1 



END 

1 

1 


4.3.9 STEXT - GENERATE SYSTEM TEXT RECORD 

As a result of an STEXT pseudo instruction, binary output for the subprogram consists of all symbols, 
micros, and opcodes (macros, opdefs, and machine and pseudo instructions), written in overlay format at 
the end of pass one. The STEXT instructions must be in the first statement group. 

The system text overlay becomes available in other assemblies through use of the G or S option on the 
COMPASS control statement (chapter 10). Through this feature, information in the system text overlay 
need be processed only once for all COMPASS programs using the same system text. System text overlays 
cannot be generated and used in the same assembly batch; system text overlays generated by one 
COMPASS control statement call can be used only by assemblies performed by later COMPASS control 
statement calls. 

The symbols included in the system text overlay written are all symbols defined in the assembly except 
those for which at least one of the following is true: 

The symbol value is relocatable or external. 

The symbol is qualified. 
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The symbol is redeflnable (i.e., defined by SET, MAX, MIN, or MCCNT)» 

The symbol is defined by statements read by XTEXT or occurring between CTEXT and ENDX, 

The symbol is defined by SST (i-e-, is a system symbol input to the present system text assembly). 
The symbol is 8 characters beginning with t l- 
All defined micros are included in the system text overlay. 

All program--defined opcodes are also included. Machine and pseudo instructions automatically 
defined by COMPASS, and opcodes defined by system text input (if any) to the assembly, are not 
included- 

When a system text overlay is used as input to an assembly through the G or S option on a COMPASS con- 
trol statement, all of the micros and opcodes in the system text are automatically defined at the start of 
each assembly; however, the symbols In the system text are defined only for those assemblies that 
contain the SST pseudo instruction. 

A system text overlay on the library is an absolute overlay that has the following control table: 



Format of Text: 


System Symbol 
Table 

2 words per entry^ 


Micro Definitions 


Macro/opdef Definitions 


Operation Table 

Entries (2 words per entry) 


Number of words in each part of overlay 
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Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

rname 

STEXT 



rname Name assigned to overlay; 1-7 alphanumeric characters, of which the first must be a 
letter (A-Z) and the last must not be a colon. It is placed in the prefix table that 
precedes the overlay. 

If rname is blanic, COMPASS uses the name from the IDENT instruction and generates 
the system text only. Otherwise, the system text is generated in addition to the re¬ 
locatable or absolute binary and precedes the binary output on the binary file. 

An entry in the variable field, if present, is ignored. 

Example: 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


n 

IB |3Q 



lOENT 

SYSTEXT 1 




STEXT 

1 




BASE 

MIXED ' 



MPRS 

EOU 

100 1 “ 

1 


• 

• 

• 1 





'system CONSTANTSt SYMBOLS, 




|ANn COMMUNICATiaNS AREAS 


« 

• 

• 1 



• 

• 

• 1 



TRTS 

EOU 

7777 1 - 



IXX/X 

OPDEF 

I,J,K 1 



• 

• 

1 



• 

• 

. ^SYSTEM-DEFINED MACROS 


• 

• 

. 'AMR OPOEFS 



ENOM 

1 



SYSCOM 

MaCRO 

N (• 



• 

• 




• 

• 

• 1 



« 

• 

. I_ 




ENDH 

n 



DATE 

MICRfl 

1,10,*...^ 1 



• 

• 

1 1 



• 

• 


STtH-OEFINFD MICROS 


• 

• 

• 




END 

u 
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I 4.3.10 COMMENT—PREFIX TABLE COMMENT 

The COMMENT pseudo instruction inserts the character string specified in the variable field into the 
eighth through fourteenth words of the PRFX table in the object program. The prefix table, and thus the 
comment, is ignored by the loader but identifies the section. If a subprogram contains more than one 
COMMENT instruction, the new comments are appended to the table for the most recent binary control 
statement. If the subprogram contains a NOLABEL instruction, the COMMENT instruction is meaningless, 
COMMENT instructions following SEG and blank IDENT pseudo instructions are ignored without 
notification. 

Format: 


LOCATION 

OPERATION 

VARlABlf 5UDF1EIDS 


COMMENT 

string 


string COMPASS searches the columns following the blank that terminates the operation 

field. If it does not find a nonblank character before the default comments coliunn (see 
COL pseudo instruction), it takes the characters starting with the default comments 
column minus one. Otherwise, the character string be^ns with the first nonblank 
character following the operation field. In either case, the last character of the string 
is the last nonblank character of the statement. 1 to 10 blanlcs are appended on the 
right so that the string is followed by at least one blank and the length of the string is a 
multiple of 10 characters. If the variable and comment fields are all blanks, the string 
consists of 10 blanks. If the string length is more than 70 characters, all characters 
beyond the 70th are lost. 

A location field symbol, if present, is ignored. Refer to section 4.3.5 for an example. 


I 4.3.11 NOLABEL-DELETE HEADER TABLE 

The NOLABEL instruction modifies the format of the binary output produced by COMPASS for an absolute 
assembly by optionally suppresang header information. It is particularly convenient for generating 
deads tart programs which must be loaded at location zero. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 


NOLABEL 

I 
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I Optional; if the variable field contains a character string beginning with an I, COMPASS 

suppresses all prefix (7700g) tables, but retains the other program header tables* 

If the I option is omitted, COMPASS suppresses all of the following; 

Prefix tables (7700g) 

Overlay control tables (5000g) 

Multiple entry point tables (SlOOg) 

PP header control tables 

A location field symbol, if present, is ignored, NOLABEL is illegal in a relocatable CPU assembly. 


4.3.12 LCC “ LOADER DIRECTIVE 

The LCC pseudo instruction provides a means of including loader directives with the tables for a 
relocatable program. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


LCC 

directive 


directive First nonblank character following LCC to the first blank. For directive formats, refer 
to the Loader reference manual. 

A location field symbol, if present, is ignored. 

COMPASS writes a directive as a section in packed display code for subsequent interpretation by the 
loader. COMPASS does not edit the directive; the loader recognizes illegal forms at load time. 


4.3.13 MEMSEL - CYBER 180 SERIES SELECT PPU 16-“BIT MEMORY SIZE 

The MEMSEL pseudo instruction is applicable to CYBER 180 Series PPU 16-bit programs only. Use of this 
pseudo instruction controls address field calculation and validation during program assembly. The m field 
of the PPU instruction set, when specifying a memory address, varies in the number of bits allowed 
dependent upon the variable subfield of the MEMSEL pseudo instruction. If used, MEMSEL must be used in 
the first statem ent group. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 


MEMSEL 

options 


options One of the following, for CYBER 180 Series PPU 16-bit programs only: 

blank or 4 aU address calculation and validation checks are based on a 4096 
word m emory (0-7777B). 

8 all address calculation and validation checks are based on a 8192 

word memory (0-17777B). Applies to CYBER 180 model 990 and 
certain model 840, 850, and 860 systems. 
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I 4.3.14 LDSET - GENERATE LDSET OBJECT DIRECTIVES 

The LDSET pseudo instruction generates loader LDSET directives for a relocatable program. A program 
may contain any number of LDSET instructions. COMPASS collects all LDSET options and writes a single 
LDSET ( 7 OOO 3 ) table in the relocatable binary output between the PRFX (7700g} table and the PIDL 
( 340 O 3 ) tables. The LDSET table is not written if LDSET instructions do not appear in the program. 
LDSET is not allowed in a PP or absolute CPU assembly. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 


LDSET 

options 


options One or more options separated by commas. See the Loader reference manual 

for further information, includng applicability to a particular operating 
system. 

LIB Clear local library set. 


LIB=libnam e Add the specified libraries to the local library set. More than one library can 
be specified by separating library names with a slash, in the form: 

libnam ej^/iibnam e 2 A../libnam e,^ 

MAP Write load map to fae OUTPUT. 

MAP=p Write load map to file OUTPUT. Map items are selected by p: 

NOS and NOS/BE SCOPE 2 

N No map. OorO 

S Statistics. S 

B Block list. B 

E Entry point list. E 

X Cross reference map. X 


No map. 

StatistiGs. 

Statistics and block list. 

Statistics, block list, and entry point 
list. 

Statistics, block list, entry point list, 
and a*OSS reference map. 
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MAP=p/lfn 

MAP:=/lfn 

PS=p 

PD=p 

PRESET=p 


PRESETA=p 


For NOS and NOS/BE, p can be written as N or as any combination of SBEX in 
any order. 

Write load map to file named Ifn. p is as above. 

Write load map to file named Ifn. Installation default determines items on the 
map. 

Select page size for load map by a specification of number of lines, p can be 
decimal 10 through 999999. A value outside this range results in the 
installation default page size. This option is not supported by SCOPE 2. 

Select print density for load map by a specification of decimal number of lines 
per inch. This option is not supported by SCOPE 2. p can be: 

6 6 lines per inch. 

8 8 lines per inch. 

other Installation default. 

Preset memory to the value specified by p. Under NOS/BE, p can be a 1 
through 20 digit octal number with an optional + or - prefix and an optional B 
suffix. 

p can also be one of the following key words: 

NONE No presetting for ECS {or for LCM and SCM under SCOPE 2): 

same as ZERO for CM 


ZERO 

0000 

0000 

0000 

0000 

0000 

ONES 

7777 

7777 

7777 

7777 

7777 

INDEF 

1777 

0000 

0000 

0000 

0000 

INF 

3777 

0000 

0000 

0000 

0000 

NGINDEF 

6000 

0000 

0000 

0000 

0000 

NGINF 

4000 

0000 

0000 

0000 

0000 

ALTZERO 

2525 

2525 

2525 

2525 

2525 

ALTONES 

5252 

5252 

5252 

5252 

5252 

DEBUG 

6000 

0000 

0004 

0040 

0000 


p can be as defined for PRESET. The lower 17 bits (CM/SCM) or lower 24 bits 
(ECS/LCM/LCME) of each word contains its address. 
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ERR=ALL 

ERR=FATAL 

ERR=NONE 

REWIND 

NOREWIN 


EPT=eptname 


NOEPT=eptnanie 


USEP=pname 


DSE=eptname 


COMMON 


Select loader abort for any loader errors. 

Select loader abort only for fatal loader errors. 

Select loader abort only for catastrophic loader errors. 

Reset the default REWIND/NOREWIN option for load files to REWIND. The 
NR parameter on LOAD and SLOAD directives can override this default for 
individual files. 

Reset the default REWIND/NOREWIN option for load files to NOREWIN. 

The R parameter on LOAD and SLOAD directives can override this default 
for individual files. 

If the symbol eptname is defined, declare it an entry point of the CAPSULE 
or OVCAP binary subsequently generated by the loader. This parameter can 
be used to specify more than one entry point; entry point names must be 
separated by a slash in the form eptnamei/eptname2/... /eptnameij. 

Do not declare eptname as an entry point of the CAPSULE or OVCAP binary 
subsequently generated by the loader. This parameter can be used to specify 
more than one entry point. In this case, entry point names must be separated 
by a slash in the form eptnamei/eptname2/... /eptnamcn. 

Cause the designated object modules to be loaded whether or not they are 
needed to satisfy external references. More than one module can be 
specified by separating module names by a slash in the form pnamex/ 
pname2/... /pnamen* 

Cause the load of object modules containing the specified entry points 
whether or not they are needed to satisfy external references. More than one 
entry point can be specified by separating entry point names by a slash in the 
form eptnamei/eptname2/... /eptnamen- 

Assign aU labeled blocks to a segment such that the blocks are available to 
all segments that reference them. Valid for segment loads only. 


COMMON=blkname Assign the labeled common block named blkname to a segment such that it is 

available to aU segments that reference it. Valid for segment loads only. 
More than one block name can be specified by separating the individual block 
names with a slash in the form blknamei/blkname2/... /blknamcn, 

SUBST=pair Treat external references to eptname]^ as though they were references to 

eptname2, where the entry point names are specified as a pair in the form 

eptnamei-eptname2. 

More than one pair of entry point names can be specified by separating the 
pairs with a slash in the form pairi/pair2/... /pairn- 

OMIT=eptname Omit satisfying external references to the specified externals. More than 

one entry point name can be specified by separating the names with a slash in 
the form eptnamei/eptname2/... /eptnamen. 

A location field symbol, if present, is ignored. 
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See the Loader reference manual for details of these parameters* including the operating system to which a 
given option applies. 


4.4 MODE CONTROL 


Mode control pseudo instructions influence the basic operating characteristics of the assembler. 
Specifically, the instructions allow the programmer to alter the way in which the assembler: 


Interprets binary data 
Generates character data 

Interprets the beginning of comments on statements 
Qualifies symbols or does not qualify them 
Interprets the R=instruction 


BASE pseudo instruction 
CODE pseudo instruction 
COL pseudo instruction 
QUAL pseudo instruction 
Bl=l or B7=l pseudo instruction 


In each ease, the assembler has a default mode which it uses if one of these instructions is never used. 


4.4.1 BASE-DECLARE NUMERIC DATA MODE 

The BASE pseudo instruction declares the mode of interpretation for numeric data for which a base radix is 
not explicitly defined. Use of the BASE pseudo is optional; if BASE is not used in a subprogram, COMPASS 
evaluates unspecified numeric data as decimal. 

An alternate application of BASE is to define the previous base as a micro- 

In addition, if no program or system micro named BASE has been defined, COMPASS changes the 
predefined BASE micro to be a single letter D, M, or O, corresponding to the new mode established by this 
BASE instruction. 

Format; 


LOCATION 

OPERATION 

VARIASIE SUBFIELOS 

mname 

BASE 

mode 


mname Optional 1 through 8 character micro name by which the previous BASE mode can be 

referenced in subsequent BASE instructions. If mname is present, the value of the micro 
named mname is (re)defined to be a single letter D, M, or O, corresponding to the BASE 
mode in effect prior to this BASE instruction. 

mode Blank, in which case the base remains unchanged, or 1 through 8 characters, the first of 

which designates the new base as follows: 

O Octal assembly base; any subsequent use of a data item not specifically 

identified by an O, D, or B prefix or suffix is evaluated as octal. For 
example, the constants 15 and 15B are evaluated as ISg; constant 15D is 
evaluated as 17g. Any item containing an 8 or 9 without a D radix is 
flagged as erroneous. Exceptions are scale factors, character counts, shift 
counts (S modifier), and binary point positions, which are always considered 
decimal, 

D Decimal assembly base; any subsequent use of a data item not specifically 

identified by an O, D, or B prefix or suffix is evaluated as decimal. 
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M Mixed assembly base; any subsequent use of a data item not specifically 

identified by an O, D, or B is evaluated as decimal if it is one of the 
following. Otherwise, it is evaluated as octal. 

VFD bit count 

IF, ELSE, or SIOP line count 

MICRO, OCTMIC, or DECMIC character count 

B, C, or I subfield in REP or REPI 

DUP or ECHO line count 

Character count 

Shift counts (S modifier) 

Scale factors 

Binary point position 

COL column number 

DIS word count 

SPACE line count 

♦ Use base in effect prior to current base. The assembler records occurrences 

of BASE pseudo instructions and maintains a table of the most recent 50 
occurrences. Each BASE * resumes use of the most recent entry and 
removes it from the list. When the subprogram contains more BASE * 
instructions than there are entries in the stack, COMPASS uses a decimal 
base. 

other If the variable field is not blank and does not contain one of the above, 
COMPASS sets an error flag. 


Examples: 


This example shows the effect of BASE on a VFD instruction defining a 48-bit field containing lOg, 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


I 


11 

IB 

ho 

Dr*0 

ooooaoanoQDDOOio 



BASF 

VFD 

0 

60/10 

-1--- 

i 




■ 

m 

1 

000 0 

OOGQQQOQQQIO 



BASE 

VFO 

• 

D 

48/9 

1 

1 




• 

• 

1 

Di*H 

QOOQOQOO 

00000010 



• 

BASE 

VFO 

• 

M 

<*6/10 

1 

1 

1 
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The following example illustrates the micro capability of BASE: 




LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


2 


11 

IB 

|30 



SflVEB 

BASE 

M 

ISAVE BASE IN USE 

1 



« 

• 

• 

• 

• 

1 

■ CODE USING BASE M 

1 



• 

• 

BASE 

#SAVEB# 

.JrESTPRE, SAVEP BA SE 



. 

iRAse;,,.!.: 

D : : ' RESTORE SAVED BASE‘ 



• 

« 

• 

• 

• 

m 

1 



• 

• 

m 

1 


4.4.2 CHAR-DEFINE OTHER CHARACTER DATA CODE 

The CHAR pseudo instruction defines character data codes to be used when the CODE O (for Other) mode 
is in effect. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


CHAR 

expl,exp2 


expl Evaluatable absolute expression whose value is 00 to 773. 

display code value of the character to be redefined. 

exp2 Evaluatable absolute expression whose value is 00 to 77g. 

code other value of the character designated by expl. 

A location field symbol, if present, is ignored. 

Initially, all code other values are the same as display code. CHAR need be used only for those characters 
whose code other values are different from display code. Characters may be redefined as many times as 
desired by subsequent CHAR pseudo instructions. 

Example: 


The value of expl is the 
The value of exp2 is the new 



LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

00t»ei3 

63'»00 


CHAN 

CHAH 

0>63b 

63B,0 

INThNCHANGE 
PERCENT FUR 

COLON AND 
CODE OTHER 


4.4.3 CODE-DECLARE CHARACTER DATA CODE 

The CODE pseudo instruction declares that until the next CODE pseudo instruction is encountered all 
constants, character strings, and character data items are to be generated in the specified code. 
Character data can be generated in ASCII (American Standard code for Information Interchange), display, 
external BCD, or internal BCD, codes. Use of the CIPPU instruction causes COMPASS to select 8-bit 
ASCII as the default, aH other COMPASS assemblies default to 6-bit display code. Codes are given in 
appendix A. 
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An alternative application of CODE is to define the previous code as a micro. 

In addition, if no program or system micro named CODE has been defined, COMPASS changes the 
predefined CODE micro to be a single letter A, D, E, I, N, or O, corresponding to the new mode established | 
by this CODE instruction. 

Form at: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 

mname 

CODE 

char 


mname Optional 1-8 character micro name by which the previous CODE mode can be 

referenced in subsequent CODE instructions. If mname is present, the value of the 
micro named mname is (re)defined to be a single letter A, D, E, I, N, or 0, 
corresponding to the CODE mode in effect prior to this CODE instruction. 

char The first character of a string indicates the code conversion: 

A ASCn six-bit subset 

D Display 

E External BCD 

I Internal BCD 

N ASCII eight-bit character set 

O Other code, defined by CHAR pseudo instructions 

* Use code in effect prior to current code. The assembler record occurrences 
of CODE pseudo instructions and maintains a table of the most recent 50 
occurrences. Each CODE ♦ resumes use of the most recent entry and 
removes it from the list. When the subprogram contains more CODE * 
instructions than there are entries in the stack, COMPASS generates display 
code. 

Example: 


Code Generated 


LOCAIION 

OPERATION 

VARIABLE COMMENTS 


1 


11 

18 ho 

1725242u25240a00u000 



DATA 

OLOUTPUT 1 

Dr*A 



CODE 

ASCII 

5765646il65 64uuiiiiJ3 0C 



DATA 

OLOUTPUT 1 

a,*e 



CODE 

EXTERNAL BCD 

4624234724 230uu0a0£»0 



DATA 

OLOUTPUT i 

Er»I 



CODE 

INTERNAL BCD 

4&646347B463JjuGj3i)U 



DATA 

OLOUTPUT 1 

Ir*D 



CODE 

DISPLAY 

172524202524uaa0UQ0g 



DATA 

OLOUTPUT 1 

nt*I 



COHE 

♦ 1 

466463476463 JOli JiiOji 



DATA 

OLOUTPUT 
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AAA QUAL ^ QUALIFY SYMBOLS 


The QUAL pseudo instruction signals the beginning of a sequence of code in which all symbols defined in it 
are either qualified or are unqualified (global). If no QUAL is in a subprogram, all symbols are defined as 
global. 

An alternative application of QUAL is to define the previous qualifier as a micro. 

In addition, if no program or system micro named QUAL has been defined, COMPASS changes the 
predefined QUAL micro to be the new qualifier name established by this QUAL instruction. 

Within a QUAL sequence in which a symbol is defined, a symbol reference need not be qualified. Used 
outside the sequence, the symbol must be referenced as/qualifier/symbol. Thus, a symbol and a qualifier 
become a unique identifier local to the sequence in which the symbol was defined. The same symbol used 
with a different qualifier is local to a different QUAL sequence. If a symbol is defined with no qualifier as 
well as being defined as qualified, a reference to the symbol within the QUAL sequence is assumed to be a 
reference to the qualified symbol rather than to the global symbol. In this ease, a reference to the global 
symbol must be written as // symbol. However, in a NOREF statement when the unqualified symbol is 
previously defined and the qualified symbol is not, COMPASS assumes the reference is to the unqualified 
symbol. 

Default symbols and linkage symbols are not qualified. 


LOCATION 

OPERATION 

variable subfields 

mname 

QUAL 

qualifier 


mname Optional 1-8 character micro name by which the previous qualifier can be referenced in 
subsequent QUAL instructions or symbol references. If mname is present, the value of 
the micro named mname is (re)defined to be the 0-8 characters comprising the qualifier in 
effect prior to this QUAL instructions. 

qualifier A symbol qualifier or * or blank, as follows: 

qualifier 1-8 character name, the first character of which cannot be $ or = or : or 
numeric. The qualifier cannot contain the characters 

+ - * / , or 

A blank terminates the qualifier. 

Any symbol defined subsequent to this QUAL up to the next QUAL must be 
referenced from outside the QUAL sequence as 

/qualifier/symbol 

The current qualifier appears as the third sub-subtitle on the assembly 
listing (section 11.1). 

* The assembler resumes using the qualifier in use prior to the current 

qualifier. The assember records occurrences of QUAL pseudo instructions 
and maintains a table of the most recent 50 occurrences. Each QUAL ♦ 
resumes use of the most recent entry and removes it from the list. When the 
subprogram contains more QUAL * instructions than there are entries in the 
stack, COMPASS uses the null (global) qualifer. 
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A blank variable field causes any symbols deHned to the next QUAL to be global. 
A global symbol does not require a qualifier. 

NOTE 

The first attempt to redefine a global symbol from within a 
QUAL sequence results in A and U errors- The symbol is 
defined local to the QUAL sequence with a zero value. To 
avoid fatal errors, precede any redefinitim instruction (SET, 

MAX, MIN, or MICCNT) within a QUAL sequence with a 
blank QUAL and follow it with a QUAL*. 


Examples: 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


11 

IB 

|30 





QUAL 

PASSl 

1 




Bror 

SX6 

• 

F 

4 

IRC HE 

1 

QUALIFIED BV PASSl 



• 

FQ 

• 

LOCI 

1 





QUAL 

PASS? 

1 




nnoE 

FQU 

LOG? 

Ircde 

OU 

flLIFIED BY PaSS2 



QUAL 

. 

4 

[SYMROLS 

1 

GLOBAL FROM NOW ON 


r7L0B 

. 

4 

0SS 

• 

4 

4 

n 

• 

i 

j&LOB 

IS 

global 



• 

RJ 

• 

1 

/PaSSi/QCDF1 JUMP 

• 1 

TO 

PASSl RDUTINF 



RJ 

. I 

/PASSP/RCDF1 JUMP 

TO 

PASS? ROUTINE 
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Location 

Code Generated 


LOCATION 

OPERATION 

variable comments 



1 


n 

)B ho 




T fip 

MArpn 

ILOrKj'^WBL 1 





DSF 

“LOrK 1 





dual 





TAGl 


1 nn 1 




TAP? 

yrn 

‘=>0/-! 1 






^ 1 

1 





nnoL 

1 





rNHM 

• 

1 

1 

1 





m 

m 

Tflq 

1 

nM'^,nMP 1 






'CNF \ : 1: 





Dijau 


10154A : 



TBGI 


np" — i 

ii!'054; 

77777777777777777776 


TAG? 


^n/-i ;• 1 '' : 


,, 


, . , . 

usF :: 

♦; . 1'.;, . 


' >' ' \ ' .. ' ' ' 

% 


Quac 



' ' \ . . . V/ '' 



rNDM 

■ ‘’'’.‘V;''/■' j ':■'';'? ! 



1 



Twr,Tw'h" ' .■ 





SlElffiSi 






QUAL 


ih'ds'S' 



TAG! 


i(jR 


7717771771177777177^ 


t AG? 

mMSB. 

P0/-1V' *1'' 





Ws&M 






SiMAiSii 






■p^NOM' ' 

' ■' V ’ if’: \ ' A|: T- •.! •’ > ' 1 a'' I . 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


If 

IB 

1 30 


7A 

lUJAL 

BSS 

z 

Q 

-1- 

Izi QUALIFIED RY 7 



• 

• 

I* 



• 

• 

> . 


Z1 

• 

DUAL 

B 

/Z/Zl 

I* 

■EQUATE SYMBOLS SO THAT 
|Z1 IN Z CAN RF referred 

ITO AS Z1 IN B 


4.4.5 B1 == 1 AND B7 = 1 - DECLARE THAT B REGISTER CONTAINS ONE 

The Bl=l and B7=l pseudo instructions declare that in this CPU subpro^’ram, the contents of the B1 
register or the B7 register, respectively, are one. These insti'uctlons do not produce code; they alter 
the way in which code is generated by the R= instruction (section 4.8.7) and define the symbol B1 1 
or B7-1. If more than one instruction is used, the assembler uses the Inst one encountered. 
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Formats: 


LOCATION 

OPEIATION 

VAitlASlE SUfiFlELDS 


Bl=l 

B7=l 



A symbol in the location or variable field is ignored. 

Note that loading the respective B register with one is the user’s responsibility. 
For an example of use, refer to R= (section 4.8.7). 


4A.6 COL - SET COMMENTS COLUMN 

The COL pseudo instruction sets the column number at which the comments field can begin when the 
variable field is blank. If no COL instruction is used in the subprogram, COMPASS uses 30. 


LOCATION 

OPERATION 

VARIABLE SUBFIE105 


COL 

n 


n An absolute evaluatable expression designating the column number; n 12. When base is M, n 

is assumed to be decimal. If n is less than 12, COMPASS sets the column at 12. If n is zero 
or blank, COMPASS sets the column to 30, the default column. 

If the current operation field extends past the current comments column, COMPASS 
substitutes a very large number for n in the current instruction only; that is, if n is less than 
or equal to the last column of the operation field, a variable field must be present if a 
comment is present. 

A location field symbol, if present, is ignored. 

Example: 


44 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


n 

18 Uo 



COL 

USE 

-1- 

36 1 

[RETURN TO BLOCK 0 

1 


In this example, subsequent statements for which the variable field is blank cannot have comments 
beginning before column 36. 
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4.5 BLOCK COUNTER CONTROL 


Counter control pseudo instructions establish local blocks, labeled common blocks, and blank common 
blocks in addition to the absolute, zero, and literal blocks established by the assembler; they control use of 
all program blocks, and provide the user with a means of changing origin, location, and position eounters. 


4.5.1 USE - ESTABLISH AND USE BLOCK 

USE establishes a new block or resumes use of an already established block. The block in use is the block 
into which code is subsequently assembled. A user may establish up to 252 blocks in a block group. 

Format; 


LOCATION 

OPERATION 

VARIABLE SUBFIEIOS 


USE 

block 


block 


Identifies block to be used, as follows: 


0 or blank 

// 


/name/ 


name 


* 


Nominal block (absolute or 0). 

Blank common block; for a relocatable subprogram, this block cannot 
contain data- The only storage allocation instructions that can follow are 
BSS and ORG. The BSSZ instruction is illegal because it presets the block 
to zeros. 

Labeled common block. A name can be a maximum of 7 characters and 
cannot include blank or comma. The first and last characters must not be 
colons. Conventions imposed by the loader or other assemblers or 
compilers could further restrict the use of names. 

Local block. A name can be 1 through 8 characters, excluding blank or 
comma. The first character must not be a colon. Use of this name 
enclosed by brackets does not cause the block to become a labeled common 
block. For example, USE A and USE/A/ are different blocks. 

Block in use prior to current USE, USELCM, ORG, or ORGC. See 
discussion following. 


A location field symbol, if present, is ignored. 

The nominal program block contains the entire program if no USE or USELCM is encountered. 
Redundancy between block names is permitted as follows. 

A labeled common block designated by /O/ can coexist with the program block designated by 0. Blank 
common designated by // can coexist with a labeled common block designated as ////. 


4-32 


60492600 H 




A CPU subprogram may have two blocks with the same name and the same memory type if they have 
different block types (local or common). Furthermore, a CPU subprogram may have two blocks 
with the same name and the same block type if they have different memory types (CM/SCM or 
ECS/LCM). Thus, altogether, there may be up to four different blocks with the same name. 

When a block is first established, its origin and location counters are zero and its*position counter is 
either 60 (CPU subprogram) or 12 (PPU subprogram). When a different block than that in use is 
indicated, COMPASS saves the values of the current origin and position counters along with an 
indicator as to whether the next instruction is to be forced upper. If the most recently assembled 
instruction under the block is one that forces the next instruction upper, the first instruction 
assembled upon resumption of the block is forced upper. When the designated block has been 
previously established, COMPASS resumes assembly in the block using the last known values for 
the origin and position counters. The value of the location counter is not saved. Upon resumption of 
the block, it is set to the value of the origin counter. If a LOG had been used previously, resetting 
of the location counter to produce the desired results is the responsibility of the programmer. 

The assembler records occurrences of USE, USELCM, ORG, and ORGC pseudo instructions (except 
USE * and USELCM *) and maintains a USE table of the most recent 50 occurrences. Each USE * and 
USELCM * resumes use of the most recent entry and removes it from the table. When the subprogram 
contains more USE * or USELCM * instructions than there are entries in the stack, COMPASS uses 
the nominal block. 


Examples: 


Location Code Generated 


. \ '■ 

LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


n 

10 

|3D 




USE 


1 

13 oionoooQon 


GAMHfl 

PJ 

ALPHA 

1 BLOCK 0 IN USF 




USF 

DATAl 

1 BLOCK DflTfll IN USP 

35 17204000000000000000 


so? 

nATA 

1. D 

1 




USE 

¥ 

1 RESUME USF OF BLOCK 0 

14 5130000000 



SA3 

SAM 

1 


Note that the SA3 is forced upper because the RJ causes a force upper of the next Instruction in the 
block, ,_,_ 


Location Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 



1 


11 

IB 

|30 





USE 


TABLE 

USE TABLE LOCAL BLOCK 

Zbl5 00 



VFD 


6/0 

t 





USE 

■ 


• 

1 RESUME 

« 

PREVIOUS BLOCK 




m 

• 

USE 


• 

• 

TABLE 

1 ■ 

I RESUME 

USING TABLE 

30002600 ^ 



VFD 


6/iRX,10/S 






USE 


* 

[RtiiUMfc 

PREVIOUS BLOCK 


Note how separate blocks can be used to facilitate packing of partial-word bytes into a table residing in 
a block other than the one primarily being used. 
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4.5.2 USELCM - ESTABLISH AND USE ECS/LCM BLOCK 


The USELCM pseudo instruction establishes or resumes use of a block assigned to extended core 
storage (ECS) or large core memory (LCM). For all ECS/LCM blocks in an absolute CPU assembly, 
and for the ECS/LCM blank common block in a relocatable assembly, data generating instructions 
(including BSSZ) and symbolic machine instructions are illegal; only storage reservation pseudo 
instructions (BSS, ORG,and ORGC) are allowed. The USELCM pseudo instruction is illegal in PPU 
assemblies. 

Format; 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


USELCM 

block 


block: Identifies block to be used, as follows: 

0 or blank Illegal, 

// Blank common block, A subprogram can have two blanlc common 

blocks if one of them is in ECS/LCM, 

/name/ Labeled common block. The name can be a maximum of 7 

characters and cannot include blanlc or comma. The first and last 
characters must not be colons. The loader or other assemblers or 
compilers could further restrict the use of names, 

name Local block, t The name can be 1-8 characters, excluding blanlc or 

comma. The first character must not be a colon. Use of this name 
enclosed by brackets does not cause the block to become a labeled 
common block. For example, A and /A/ are different bloclcs. All 
of the local ECS/LCM blocks are concatenated to form a single block, 
which is treated by the loader as an ECS/LCM common block whose 
name is unique to the subprogram. 

* Block in use prior to current USE, USELCM, ORG, or ORGC. 

A location field entry, if present, is ignored. 

The length of each ECS/LCM block, including the combined local block, is rounded up, if necessary, 
to an integral multiple of eight 60-bit words. The maximum size of an ECS/LCM block is 1,048,568 
words. 

Further rules for USELCM are the same as for USE. 


t SCOPE 2 does not currently allow local blocks in LCM, 
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Examples: 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


11 

IB 

|30 



BASE 

0 

-t- - 

1 



USELCM 

LCH 

1 

IESIABLISH and use lum block 


LCHC 

BSS 

0 

iUEFINE SyMBOL LCMC 


BLOCl 

BSS 

100 

[RESERVE 100 WORDS 


BLOC2 

BS5 

200 

[RESERVE 200 WORDS 



U^E 

• 

• 

[RESUME PREVIOUS BLOUk 

1 



ORG 

• 

BLOCi^^lOOQB 

1 

] 


BLOCS 

BSS 

20 

(reserve 20 MORE WORDS 



USE 


[resume PREVIOUS BLOUK 


4.5.3 ORG AND ORGC « SET ORIGIN COUNTER 


ORG Indirectly indicates the block to be used for assembly of subsequent code and specifies the value 
to which (he origin and location counters are to be set, COMPASS makes an entry in the USE table and 
saves the current origin and position counter values, 

ORGCt indirectly indicates the block to be used for assembly of subsequent code and specifies the value 
to which the origin and location counters are to be set, COMPASS makes an entry in the USE table and 
saves the current origin and position counter values. In a PPU or absolute assembly, ORGC is the 
same as ORG. In a relocatable CPU assembly, ORGC is the same as ORG if the USE block specified 
by the address expression is not a common block; otherwise, code following an ORGC is ignored by 
the linking loader if that common block was first declared by a previously loaded subprogram. If two 
or more programs in a load sequence preset relocatable text within the same common block, the ORGC 
must be used; otherwise, multiple relocation of those words can occur. 

Formats: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


ORG 

exp 


ORGC 

exp 


exp Expression specifying the address to which the origin and location counters are to be 

set. Following ORG or ORGC, the assembly resumes at the upper position of the 
location specified. COMPASS determines the block as follows: 


t Not supported by SCOPE 2 Loader. 
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1. If the expression contains a S 3 anboUc address, COMPASS uses the block in 
which the symbol was defined. 

2. COMPASS uses the current block if the value of the expression is *, *L, or 
*0. If the origin and location counters are the same value, and no code has 
been assembled in the current location, the only effect of *, *L, or +0 is to 
force the next instruction upper. If a word is partially assembled, however, 
the code already assembled into the location is lost. 

If the counter values differ, * or *L sets the origin counter to agree with the 
location counter value; *0 seta the location coimter to the origin coimter value. 

3. An absolute expression causes use of the absolute block. In a relocatable 
assembly, this is the only way to establish the absolute block. All symbols 
defined in the absolute block are absolute. 

Any s 3 rmbols in the expression must be already defined in the assembly and must not result in a 
negative relocatable value. It is not possible to ORG or ORGC into the literals block. 

A location field symbol, if present, is ignored. 

Once an ORGC pseudo instruction has established the conditional loading indication for a given common 
block, it is in efiect whenever assembly in that block is resumed by subsequent USE or USELCM 
pseudo instructions, and can be cleared only by an ORG pseudo instruction specifying that block. 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


I 


n 

18 

ho 








USE 

ALPHA 





• 

• 

1 • 




• 

• 

1 • 




• 

m 

1 • 



ABC 

DATA 

eOylOQylOQQ 

iLOCaiED IN 

i 

ALPHA 



• 

• 

• 




m 

• 

* • 




USE 

BETA 

1 



XY7 

BSS 

0 

[LOCATED IN 

BETA 



• 

• 

1 a 




• 

m 

' 9 




• 

• 

' 9 




ORG 

1 ABC 

ISETS ALPHA 

COUNTERS TO ABC 



• 

1 

• 

j 

|AND RESUMES 

USE OF ALPHA 



• 


1 ■ 




BSS 

1000 

1 




• 

• 

9 

t 




« 

• 

* • 
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LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


tl 

IB 

ho 



org“ 


ISETS ABSOLUTE BLOCK COUNTER 



• 

■ 

|TO 50 AND BEGINS ITS USE 



ORG 

m 

KTZ+lOO 

• 

• 

ISETS BETA COUNTERS TO XYZ+IOQ 



USE 

• 

• 

• 

r 

• 

IRESUHES ABSOLUTE BLOCK 

I- 



• 

USE 

« 

• 

IP 

« 

r 

'resuhes block alpha 

1 

• 

1 



m 

USE 

• 

■ 

« 

• 

• 

* • 

1 • 

[RESUMES BLOCK BETA 

i« 



• 

USE 

• 

• 

• 

I 

i: 

IRESUHES BLOCK ALPHA 

h 



• 

■ 

USE 

• 

• 

i: 

[resuhes nohinal block 



USE 

• 

/DATA/ 

• 

1 


DATA 

BSS 

Q 

1 

I 



O^GC 

DATA 

1 



DftFA 

1»2,3 

IcONDlTTDNALLY oprsET DATA 

1 



USE 

ANYBLOCK 

1 



OQN 

3RXYZ 

♦unconditional DATA 



USE 


t 


FOUR 

DATA 

4 

[RETURN TO /DATA/ STILL 



BATA 

5,6 

'conditionally skipping 

1 



ORG 

FOUR 

1 

1 



ZR 

XI,ERROR 

Iunconditionally loaded 



RJ 

■ 

• 

• 

SUB4 

|INSTRUCTIONS 

1 

J 


4.5.4 BSS~BLOCK STORAGE RESERVATION 

The BSS instruction reserves core in the block in use by adjusting the origin and location counters. It 
does not generate data to be stored in the reserved area. A primary application is for reserving blanlv 
common storage. It can also be used to reserve an area to receive replicated code (see REP, REPC, 
and REPI, section 4.8.8). 


60492600 H 


4-37 












Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

sym 

BSS 

aexp 


If present, sym is defined as the value of the location counter after the force 
upper occurs- It is the beginning s 5 mibol for the storage area. 

Absolute expression specifying the number of storage words to be reserved. 

All symbols must be previously defined; aexp cannot contain external symbols. 
The value of the expression can be negative, zero, or positive and the value 
is added to both the origin counter and the location counter. A BSS 0 or an 
erroneous expression causes a force upper and symbol definition but no storage 
is reserved. 


Example; 



4.5,5 LOC - SET LOCATION COUNTER 

A LOC pseudo instruction sets the value of the current location counter to the value in the variable 
field expression. The location counter is used for assigning address values to location symbols. 
Changing the location counter permits code to be generated so that it can be loaded at the location 
controlled by the origin counter and moved and executed at the location controlled by the location 
counter. Thus, any addresses defined while the location counter is different from the origin counter 
will be correctly relocated only after the code is moved. 

Format* 


LOCATION 

OPERATION 

VARIABLE SUBFiELDS 


LOC 

exp 
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exp Relocatable expression specifying the address to which the location counter 

is to be set- Any symbols in the expression must be already defined in the 
assembly and must not result in negative relocation. 

A location field symbol, if present, is ignored. 

Following a LOG, if the value of the location counter differs from the origin counter, the location field 
is flagged with an L on the listing until a LOG *0, USE, ORG, ORGG, or USELGM instruction resets the 
location counter to the value of the origin counter♦ 

A LOG instruction does not affect the origin counter except that it causes the next instruction to be 
forced upper. The only effect of LOG * or LOG *L is to force upper. Because COMPASS does not 
save the value of the location counter when it switches blocks, a USE, ORG, ORGG, or USELGM for 
a different block effectively resets the location counter to the origin counter value. When use of the 
block is resumed, it is the responsibility of the user to reset the location counter to produce the desired 
results. 


Example: 

In the following example, the first LOG is used to generate PPU code that is to he loaded into one 
PPU and transmitted to a different PPU for execution. The second LOG is used so that on the listing 
the address field contains the table ordinal rather than a load address. At the end of the table, a LOG 
instruction changes the location counter to resiune coimting under the first LOG. At the end of the 
program, LOG *0 returns the location counter to the value of the origin counter. 







LOCATION 

OPERATION 

VARIABLE COMMENTS 

Location 

Code Generated 


\ 


11 

IS Iso 












1 


T1 

EQU 

1 ' 




0 


CH 

EdU 

0 1 


7100 





ORG 

7ion 1 


7100 




RFS 

BSS 

0 , 

L 

10 0 





LOG 

100 1 

L 

10 0 

2400 



PPP 

PSN 

0 1 

L 

101 

2400 




PSN 

“ 1 

L 

102 

2400 




PSN 

0 1 

L 

103 

6100 0100 




EIM 

PPR,CH 1 






• 

m 

1 






• 

• 

• 1 

L 

205 




• 

PPRfl 

• 

RSS 

S i 

L 

0 





LOG 

0 1 

L 

0 

0100 




CON 

PPR 

L 

1 

0114 




CON 

STM 1 

L 

2 

0121 




CON 

DPM I 

L 

3 

0132 




CON 

EXR ' 

L 

4 

0136 




CON 

CHS 1 

L 

5 

0147 




CON 

OMP 1 

L 

6 

0240 




CON 

END 

L 

7 

1000 




CON 

1000 1 






■ 

• 

m 1 






■ 

• 

• 1 
• 

L 

215 





LOC 

•-D-RES+PPR 1 

L 

215 . 






240-* 1 

L 

240 




END 

BSS 

1 


7240 





LOC 

*0 1 


60492600 H 4-39 








4.5.6 POS - SET POSITION COUNTER 


The POS pseudo instruction sets the value of the position counter for the block in use to the value specified 
by the expression in the variable field* 

Format: 


LOCATtON 

OPERATION 

VARIABLE SUBFIELD5 


POS 

aexp 


aexp An absolute evaluatable expression having a positive value less than or equal to the 

assembly word size (60 for CPU, 12 or 16 for PPU). A negative vaue, or a value greater 
than the applicable limit, causes an error. The value indicates the bit position within 
the current word at which the assembler is to assemble the next code generated. Use 
caution, because if the new position counter value is greater than the old position 
counter value, part of the word is reassembled. (New code is ORed with previously 
assembled data.) If the new position counter value is less than the old position counter 
value, the assembler generates zero bits to the specified bit position. If the value of 
aexp is zero, COMPASS assembles the next code in the following word. 

A location field symbol, if present, is ignored. 

NOTE 

If the POS instruction is used on a word containing relocatable or 
external addresses, undefined results can occur with no diagnostics. 


The POS instruction does not alter the origin and location counters. The position counter is never 0 at the 
beginning of an instruction. At the beginning of a new operation, if a data value has been stored into bit 0 
(the rightmost bit) of a word, COMPASS increments the origin counter and the location counter and resets 
I the position counter to the applicable limit. 

A POS *P has no effect whereas a POS $ subtracts one from the counter. 


4.6 SYMBOL DEFINITION 

The pseudo instruction EQU, =, SET, MAX, MIN, and MICCNT permit direct assignment of 21-bit values to 
symbols. The values can be absolute, relocatable, or external. Register designators are not valid in the 
expressions. Subsequent use of the symbol in an expression produces the same result as if the value had 
been used as a constant. In the listing of the symbolic reference table, a reference to an EQU, SET, 
MAX, MIN, or MICCNT instruction is flagged with a D. Smybols defined using EQU and = cannot be 
redefined; symbols defined using any of the other symbol definition instructions can be redefined. 
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4.6J EQU OR EQUATE SYMBOL VALUE 

An EQU or = pseudo instruction permanently defines the symbol in the location field as having the value 
and attributes indicated by the expression in the variable field. 

Formats: 



sym A location symbol is required. See section 2.4 for symbol requirements. 

exp An evaluatable expression. Any symbols in the e^q>ression must be previously 

defined or declared as external. The expression cannot contain symbols 
prefixed by -S, =X, or =Y unless the symbols have also been defined conven¬ 
tionally. If the expression is erroneous, COMPASS does not define the location 
symbol but flags an error. 

Examples: 



4.6.2 SET -- SET OR RESET SYMBOL VALUE 

A SET pseudo instruction defines the symbol in the location field as having the value and attributes 
indicated by the expression in the variable field. A subsequent SET using the same symbol redefines 
the symbol to the new value and attributes. SET can be used to redefine symbols defined by SET, MAX, 
MIN, or MICCNT, only. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

sym 

SET 

exp 
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syjn A location symbol is required. See section 2- 4 for symbol requirements. 

exp An evaluatable expression. The expression cannot Include symbols as yet undefined 

and cannot contain symbols prefixed by =S, -X, or unless the symbols are 
also defined conventionally. 

If the expression is erroneous, COMPASS does not define the symbol but 
issues a warning flag. 

The symbol in the location field cannot be referred to prior to its first definition. 

Examples: 




LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


i 


11 

IB 

|ao 

17 


A 

EQU 

15 

1 A HAS VALUE OF 15 

74 


B 

SET 


B HAS VALUE OF POSITION COUNTEI 

32 


C 

SET 

A4-3 

* C HAS VALUE A+3 OR 18 

76 


0 

= 

04^2 

1 ILLEGAL» e IS DOUBLY DEFINED 

1 

24 


C 

SET 

C+2 

t 

1 LEGAL, C CHANGES FROM 18 TO 20 



D 

SET 

F4‘A 

1 ILLEGAL, F AS YET UNDEFINED 




BSS 

AA 

[ILLEGAL, REFERENCE PRECEDES 

1FIPST DEFINITION 

20 


AA 

SET 

16 

1 

1 


4.6.3 MAX - SET SYMBOL TO MAXIMUM VALUE 


The MAX pseudo instruction defines the symbol in the location field as having the value and attributes 
indicated by the largest (most positive) value of the expressions in the variable field. A subsequent 
SET, MAX, MIN, or MICCNT using the same symbol redefines the symbol to the new value. 
Conversely, MAX can be used to redefine symbols defined by these instructions. 


Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIOS 

sym 

MAX 

exp^, exp29 • • •» 


sym A location field symbol is required. See section 2.4 for symbol requirements. 


exp. 


An evaluatable expression. Any symbols in the expression must be previously 
defined. The expression cannot contain symbols prefixed by =^, or =X, or -Y 
unless the symbols are also defined conventionally. 
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The ejpressions should have similar attributes. No test is made for attributes. The test for maximum 
value is made in pass one. In testing for the maximum value in pass one, COMPASS uses values for 
relocatable symbols relative to block origins. 

NOTE 

During pass two, the expression selected in pass one is 
used. The relocatable symbols have been reassigned 
values relative to program origin and these values are 
used for the final value of the expression selected in the 
first pass. 

If any of the expressions are erroneous, COMPASS does not define the symbol but issues a warning flag* 
The symbol in the location field cannot be referred to prior to its first definition. 

Example; 




LOCATION 

OPERATION 

VARIABLE COMMENTS 


J. 


tl 

18 ho 

5 


PT3 

EQU 

5 ! 

6 


PT31 

EQU 

6 1 

2 


PT32 

EQU 

2 J 

I 

6 


SYM 

MAX 

PT3,PT31,PT32 

1 


4,6.4 MIN ^ SET SYMBOL TO MINIMUM VALUE 

A MIN pseudo instruction defines the symbol in the location field as having the value and attributes 
indicated by the minimum or least positive value of the expressions in the variable field, A subsequent 
SET, MAX, MIN, or MICCNT using the same symbol redefines the symbol to the new value. 
Conversely, MIN can be used to redefine symbols defined by these instructions. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

sym 

MIN 

expj^, exp29 • • •» ^^^n 


sym A location symbol is required (section 2.4). 

ejqi. An evaluatable expression. Any symbols in the expression must be previously 

defined. The expression cannot contain symbols prefixed by =X, or =Y, 
unless the symbols are also defined conventionally. 

The expressions should have similar attributes; no test is made for attributes. 

The test for minimum value is made in pass one. In testing for the minimum value in pass one. 
COMPASS uses values for relocatable symbols relative to block origins. 
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NOTE 


During pass two, the expression selected in pass one is 
used. The relocatable symbols have been reassigned 
values relative to program origin and it is these values 
that are used for the final value of the expression which 
was selected in the first pass. 

If any of the expressions are erroneous, COMPASS does not define the symbol but issues a warning 
flag. 

The symbol in the location field cannot be referred to prior to its first definition. 


4.6.5 MICCNT SET SYMBOL TO MICRO SIZE 

The MICCNT pseudo instruction defines the symbol in the location field as having a value equal to the 
number of characters in the value of the micro named in the variable field. A subsequent SET, MAX, 
MIN, or MICCNT using the same symbol redefines the symbol to the new value. Conversely, MICCNT 
can be used to redefine symbols defined by these instructions. 

Format: 


tOCATION 

OPERATION 

variable subfielos 

sym 

MICCNT 

mname 


sym A location symbol is required (Section 2.4). 


mname Name of a previously defined micro; it may be a system micro or may have 

been defined through MICRO, OCTMIC, DECMIC, or BASE. If mname has 
not been previously defined, the location symbol is not defined (or redefined) 
and a warning flag is issued. 


Example: 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


It 

IB 

|30 




.- . 1 : 


MSG 

MICRO 

• 

It .’STRING* joFFlNE 6-CHARflCTFR MICRO 

1- 


MSIZE 

• 

MICCNT 

■ 

• 

m 

MSG 

• 

I* 

a 

'MSIZE EQUALS 6 

1 . 


MSG 

• 

■ 

MICRO 

• !• 

• !• 

1, ,'*^ALPHaNUMERIC 19 CHAR. MICRO 


MSG 

MICRO. 

it V’^AJ-PHANUMERIC StRING*,,:.-.!?: CHAR.-HHICROli 


MSIZE 

MICCNT 

MSG 

IhSIZE equals 19 
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4.6.6 SST--SYSTEM SYMBOL TABLE 


An SST pseudo instruction defines system symbols, with the exception of the symbols noted, as if the 
symbols had been defined in the subprogram. 

When a system text overlay is used as input to an assembly through the G or S option on a COMPASS 
control card, all micros and opcodes in the system text overlay are defined automatically at the start 
of each assembly; however, the symbols in the system text overlay are defined only for assemblies 
that contain the SST pseudo instruction. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELOS 


SST 

syin^,sym2 .--.,Bym^ 


sym. One or more symbols on the file that are not to be defined. 

A location field s 3 TiLbol, if present, is ignored. 

Refer to section 10.2 for an example of SST use. 


4.7 SUBPROGRAM LINKAGE 

Pseudo instructions ENTRY, ENTRYC, and EXT do not define symbols but either declare symbols 
defined within the subprogram as being available outside the subprogram or declare symbols referred 
to in the subprogram as being defined outside the subprogram. 


4.7.1 ENTRY AND ENTRYC - DECLARE ENTRY SYMBOLS 

The ENTRY pseudo instruction specifies which of the symbolic addresses defined in the subprogram 
can be referred to by subprograms compiled or assembled independently; ENTRY lists entry points to 
the current subprogram« ENTRY is illegal in PPU assemblies. 

The ENTRYC I pseudo instruction conditionally specifies which of the symbolic addresses defined in 
the subprogram can be referred to by subprograms compiled or assembled independently; ENTRYC 
lists conditional entry points to the current subprogram. ENTRYC is illegal in PPU assemblies and 
is synonymous with ENTRY in absolute CPU assemblies. In a relocatable assembly, an entiy^ point 
symbol declared by ENTRYC is ignored by the linking loader if the value of the symbol is relative to a 
common block and that common block was first declared by a previously loaded subprogram. 


tNot supported by SCOPE 2 Loader. 
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Formats: 


LOCATION 

OPERATION 

VARIAfilE SUBFIEIOS 


ENTRY 

sym^, sym^,..., sym^ 


ENTRYC 

sym^tSym^.-.-tSym^ 


sym Linkage symbol; 1“7 characters of which the first must be alphabetic (A-Z) and the 

last must not be a colon. The symbol cannot include the following characters: 

+ “• * / blank , or A 

Each symbol must be defined in the subprogram as nonexternal (cannot begin with 
-X or =Y or be listed on an EXT pseudo instruction). Entry point symbols must be 
unqualified (section 2.4.5). 

A location symbol, if present, is ignored. 

A list of all entry points declared in the subprogram precedes the assembly listing. An asterisk 
appears to the right of each conditional entry point. 


Example: 


Location Code Generated 


lOCATION 

OPERATION 

VARIABLE COMMENTS 


1 


11 

ie Uo 





I .-. 




TD^NT 

CT,CONTROL fCjoNTROL 





! 




FNTRY 

tlOOE 1 




ENTRY 

ONSW j 




ENTRY 

OFFSW 1 




FNTRY 

ROLLOUT 1 

• 



ENTRY 

SETPP , 




ENTRY 

SETTL 1 




ENTRY 

SWITCH 1 

110 



ORG 

lion 

110 


CONTROL 

PSS 

0 I 

110 5120000100 


^ODE 

SA2 

ACTP 1 

7?72n 



SX7 

X2 ' 

111 5110000002 



SAl 

? 1 




• 

1 

• 




• 

• ’ 





« 1 
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4.7.2 EXT - DECLARE EXTERNAL SYMBOLS 


The EXT pseudo mstruction lists symbols that are defined as entry points in independently compiled or 
assembled subprograms for which references can appear in the subprogram being assembled. The 
EXT pseudo instruction is illegal in an absolute subprogram. In a relocatable subprogram, EXT 
defines symbols as strong externals (section 2.4.1). 

Format; 


LOCATION 

OPERATION 

VARIABLE SUBFIELOS 


EXT 

sym^, synig,..., sym^ 


Linlcage symbol, 1-7 characters of which the first must be alphabetic (A--Z) and th< 
last must not be a colon. The symbol cannot include the following characters; 

+ “ * / blanlc , or a 

These symbols must not be defined within the subprogram. External symbols 
are unqualified. 


A location field symbol, if present, is ignored. 

An external reference is flagged with an X in the address field in the listing of code genex'ated. All 
external symbols are listed in the header information for the assembly listing. 

4.8 DATA GENERATION 

The instructions described in tliis section are the only pseudo instructions that generate data. All 
other program data is generated through symbolic macliine instructions. An instruction that 
generates data cannot be used in a blanlc common block. The pseudo instructions that generate data 
are; 


BSSZ Generates zeroed words 

blanlc operation field Generates one zeroed word 


DATA 

DIS 

LIT 

VFD 

CON 

REP, REPC, or REPI 


Generates one or more words of data 
Generates one or more words of data 
Generates literals block entries 
Places expression values in user-defined fields 
Places expression values in full words 

For use in macros; R= assumes that either (Bl)=l or (B7)-l and 
generates increment instructions accordingly 

Does not actually generate object code at assembly time but 
causes the relocataljle loader to repeatedly load a sequence of 
code into a reserve^d blanlc storage area. 
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4.8.1 BSSZ AND BLANK OPERATION FIELD - RESERVE ZEROED STORAGE 


The BSSZ instruction reserves zeroed core in the block in use. The origin and location counters are 
adjusted by the requested number of words and the assembler generates data words of zero to be loaded 
into the reserved area. An instruction that contains a symbol in the location field but has a blank operation 
field has the same effect as a BSSZ of one word. 

Format: 


lOCATJON 

OPEBATION 

VARIABLE SUBFIEIOS 

sym 

BSSZ 

aexp 


sym If present, sym is defined as the value of the location counter after the force upper 

occurs. The symbol identifies the beginning of the reserved storage area. 

aexp Absolute evaluatable expression specifying the number of zeroed words of storage to be 

reserved. The expression CEinnot contain external symbols or result in a relocatable or 
negative value. 

A BSSZ 0 or an erroneous expression causes a force upper and symbol definition but no storage is reserved. 

A BSSZ or group of BSSZ instructions of six or more words produce an REPL table in object code to reduce 
the physical size of the object program (appendix B). 

For a blank operation field the listing shows one zero word of data; for a BSSZ instruction the listing shows 
the word count. 


4.8,2 GENERATE DATA WORDS 

I The DATA pseudo instruction generates one or more complete 60-bit, 16-bit, or 12-bit data words in the 
current block for each item listed in the variable field. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 

sym 

DATA 

item^jitem 2,.«**,item|^ 


sym If present, sym is assigned the value of the current location counter after the force 

upper occurs. It becomes the symbolic address of the first item listed. 
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item^ Character, octal numeric, or decimal numeric data item, according to 

specifications described in section 2,7. Floating point notation is illegal in 
PPU assemblies. Items are separated by commas and terminated by a blanlt. 

A literal cannot be used as an item. 

A DATA pseudo instruction always forces upper. A blanlc item does not cause generation of a data word. 
Unless the D list option is selected, only item^ appears on the listing. 

Examples: 

Location Code Generated 

592 140717OOQOQQQOQ0QQaO 

553 400DOOQOQQO{1QOOOQODQ 

554 03171520111405000000 

555 17252420252400000000 

556 QOQQOOOQOQOOOOQQOQOO 

557 17205146314631463146 

560 16403146314631463146 



Location Code Generated 


0i»0 


1250 

7070 

1251 

7770 

1252 

0000 

1253 

0034 

1254 

5501 

1255 

0000 

1256 

0506 

1257 

0123 

1260 

7773 

1261 

0401 

1262 

2401 



4.8.3 DIS—GENERATE WORDS OF CHARACTER DATA 

The DIS pseudo instruction generates words containing character data. The instruction can be used 
conveniently when a character data string is to be used repeatedly. Unless the D list option is selected 
only the first word of character data appears on the listing. The instruction has two formats; 
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Format one: 


lOCATION 

OPEIATiON 

VARIABIE SUBFIELDS 

sym 

DIS 

n, string 


gym If present, sym is assigned the location counter value after the force upper 

occurs. It is the symbolic address of the first word containing the character 
string. 

n An absolute evaluatable expression specifying an integer number of words to be 

generated. When base is M, COMPASS assumes that n is decimal. 

string Character string 

For a CPU program, COMPASS takes 10 times n characters from the string and packs them as they occur 
10 characters per word into n words. For a PPU program, COMPASS talces two times n characters from 
the string and packs them as they occur two characters per word into n words. If the statement ends 
before 10 x n (or 2 x n) characters, the remainder of the requested words are filled with blanks. 

If n is 0, COMPASS assumes the instruction is in format two. 

Format two: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIOS 

sym 

DIS 

jdstringd 


sym If present, sym is assigned the location counter value after the force upper 

occurs. It is the symbolic address of the first word containing the character 
string. 

d Delimiting character 

string Character string; any character other than delimiting character 

In this form, the string must be bounded by delimiters. The comma is required. The characters between 
the two delimiting characters are packed into as many CPU or PPU words as are needed to contain them. 
Twelve zero bits are guaranteed at the end of the character string even if COMPASS must generate an 
additional word for them. If COMPASS detects the end of the statement before it detects a second 
delimiting character, it produces a fatal error. 
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Examples 


Locatidn Code Generated 


LOCATION 

OPERATION 

VARJABIE 

COMMENTS 


J 


II 

18 

[30 

561 070516a522D12<>055535 

562 55032025552717220623 


ONE 

OIS 

2fGENERATE 

pi CPU WORDS 

1 

563 07051605220124055535 

564 55032025552717220423 

565 00000000000000000003 


TNO 

DIS 

,*GENERATE 2| CPU WORDS^ 

1 

1 


Location 


1402 

14Q3 

1404 

1405 

1406 
140? 

1410 

1411 

1412 

1413 

1414 

1415 

1416 

1417 

1420 

1421 

1422 

1423 

1424 

1425 

1426 


Code Generated 


0705 

1605 

2201 

2405 

5534 

3355 

2020 

5527 

1722 

0423 

0705 

1605 

2201 

2405 

5534 

3355 

2020 

5527 

1722 

0423 

OUOl) 


OfM 



4.8.4 LIT - DECLARE LITERAL VALUES 


A LIT pseudo instruction generates data words in the literals block. This instruction and the 
- prefix to a data item provide the only means of generating data in the literals block. The LIT 
pseudo instruction assures sequential entries for a table of values. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIOS 

sym 

LIT 

item^, itemg >..., item^ 
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sym 


If present, sym is assigned the value of the literals block location counter. 


item. At least one and not more than 100 words of character, octal numeric, or 

' ^ decimal numeric data items. Section 2,7.3 contains specifications. Items 

are separated by commas and terminated by a blanlc. Floating point data 
items axe illegal in PPU assemblies. 


COMPASS enters data items into the literals block in the order specified. 

If'the converted binary values for all the data items listed with a single LIT match an existing literal 
block sequence, they are not duplicated. If, however, any item in the list does not match an entry in 
the block, the entire sequence is generated. A literal item subsequently referred to through an 
— prefix is not duplicated. A null item (e. g. H** or OL) does not cause a word to be generated. 

Examples; 


Location Code Generated 


LOCATION 

OPERATION 

VARIARLE 

COMMENTS 


— 


n 


|30 


611 I IPOOL I LIT I 3.1,1.59265,2.7182182,57.2g57795EEl 


CONTENT CF LITEPPIS BLOCK. 
000611 17216146314631463146 OOf-Y-Y-Y- 

000612 17206275576441776271 0P]>.^6; 

000613 17215337351136014426 0Q?4?I1A9V 

0 00614 17314363651440 663121 0Yaif*L5vYQ 

000615 16513333Q3354 05765 66 N(0OC25.f*v 



CONTENT OF LXTFRAL5 BLOCK. 


7447 

0 034 

1 

7%50 

7070 


7451 

0007 

G 

7452 

0000 


7453 

5501 

A 

7454 

0000 


7455 

0506 

EF 

7456 

1411 

LI 

7457 

2405 

TE 

7460 

2201 

RA 

7461 

1423 

LS 
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4.B.5 VFD - VARIABLE FIELD DEFINITION 


The VFD toe true tion generates data in the current block by placing the value of an expression into a 
field of the specified 6lze< 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

eym 

VFD 

itemj^/ejqjj^, item2/exp2 . 


sym For a CPU assembly, the location field can contain sym, plus, minus, or 

blank, as follows: 

sym If a symbol is provided in the location field, a force upper occurs 

and the value of the location counter following the force upper is 
assigned to the symbol. The symbol identifies the first word of 
data generated by the VFD, 

Causes a force upper. Data generation begins in a new word, 

COMPASS generates zero bits to the next quarter word boundary, 
at which point the first field begins. 

blank COMPASS begins the first field at the current value of the position 

counter. 

For a PPU assembly, if the location field contains a plus, minus, or a symbol, 
data generation begins in a new word. If the location field is blank, the first 
field begins at the current value of the position counter. 

An unsigned constant or previcnisly defined symbol having a value specifying a 
positive integer number of bits for the field to be generated; maximum field 
size is 60 bits for both CPU and PPU assemblies (60 being the maximum 
number of significant bits for an expression value). When base is M, item, 
is assumed to be decimal notation. 

An absolute, relocatable, or external expression, the value of which will be 
inserted into the field specified by itemi. The expression is evaluated using 
the specified field size. Character constants are right or left justified in the 
field according to the type of justification indicated. In a relocatable CPU 
assembly, no field that contains a relocatable or external address expression 
can cross a 60-bit word boundary, and no 60-bit word can have more than 
four fields that contain relocatable or external address expressions. 


item. 


exp^ 


Each field is generated as it occurs. For a CPU assembly, if the next instruction that generates code 
in the block is not a VFD with a blanlt location field, and the last VFD field in the current VFD ends to 
the left of a quarter word boundary, COMPASS inserts zero bits up to the next quarter word boundary. 
These zero bits do not show on the assembly listing. Remaining parcels are then filled with no¬ 
operation instructions. 
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When a VFD instructicm that does not have a location field entry immediately follows another VFD in the 
same block,, no padding with zeros or forcing upper occurs; fields are generated sequentially as they are 
^ecified. 

Following a VFD, the position counter contains the number of bits remaining to be assembled in the last 
word in which data was generated by the VFD. 


Examples: 


In the first example, the symbol TABLOC has been defined earlier in the program and associated with 
000551. 


Location Code Generated 


31 

566 24ai02anQ0Q02300l}55i 

567 00000005665555555555 

570 777777774 

000000000000 

571 11172401550155555531 

572 00000015052323010705 

573 031117000000033 


Location Code Generated 


0(»H 


1310 

333% 

1311 

3536 

1312 

3740 

1313 

4142 

1314 

4344 

1315 

ODiO 

1316 

QQll 

1317 

7765 

1320 

0707 

4.8.6 CON 

- GENERATE 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


11 

IB |30 






ALPHA 

SFT 

25 , 


TABLE 

VFG 

36/3CTAB,6/iq,lfl/TABL0n 



VFD 

3D/*-l,3n/5H ,ALPHA/-D 

1 



VFD 

1 

»P/ 1 



VFD 

30/aHIOTA,6/lRA,24/DAX+l 



VFD 

60/nRMFSSAGEf?Q/3LniOtl5/ORD 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


IT 

18 ho 




. ' 1 . . .. 


N4 

PPU 

BASE 

VFD 

1 

K 1 

60/10Rt)123456789 

1 

1 


All 

VFG 

! 

1 

12/10,12/11,12/-12,12/-7070 

1 

1 


The CON pseudo instruction generates one or full words of binary data in the block in use. It differs 
from DATA in that it generates expression values rather than data items and differs from VFD in that the 
field size is fixed. For relocatable or external addresses, CON generates a 60-bit address constant that is 
not appropriate for routines built into capsules or overlay capsules. 


Format 


LOCATION 

OPERATION 

VARIABLE SUBFIELOS 

sym 

CON 

6xp^ 9 • • ■ • » 


sym If present, sym is assigned the value of the location counter after the force upper occurs. 

expi An absolute, relocatable, or external expression the value of which will be inserted into a 
field having a size of one word. For PPU assembly, floating point is not allowed; for CPU 
assembly, double precision is not allowed. 
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Examples: 


In the first example, the symbols FAIL and PASS have been defined earlier in the program and associated 
with 2204 and 2172, respectively. 



Location 

Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 




1 


11 

IB 

Uo 


l46n 

nooo 


MSril 


6 

.... 1 — 


1461 

0006 



caM 

6 

1 


146? 

no 0.3 



CQt>i 

■g 

1 


1461 

??04 




Fail 

1 


1464 

nn?4 



r 

?n 

1 


146S 

nono 


mSc? 

r 

n 



1466 

0006 



C 

fi 

1 


1467 

000*^ 



C.n\ 

3 



1470 

?!?:> 



CnA 

PASS 

1 


1471 




r 


J 


Location 

Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 




1 


n 

IB 

ho 


574 





1 .... 




Tftn 1 

PSS 

nr 


L 

0 



1 

LOC 

0 

1 

L 

n 

00000090000000000055 



roN 

tR 

lOO 

L 

1 

0000000000000000006? 



TON 

IRI 

,61 

L 

? 

00000000000000000064 



rciN 

IRi 

'02 

L 

3 

00006000000000000060 



TON 

• 

1R = 

• 

1 03 

1 • 

L 

75 

00000000000000000066 



t 

m 

CON 

• 

• 

IRv 

1 • 

I 75 

L 

76 

00000000000000000076 



TON 

IP*" 

1 

L 

77 

00000000000600000055 



COM 


1 77 


674 




LOC 

*0 

1 


4.8.7 R CONDITIONAL INCREMENT INSTRUCTION 


The R= pseudo instruction generates a CPU increment unit instruction depending on the contents of the 
variable subfields and on whether or not the subprogram earlier contained a Bl==l or B7=l pseudo 
instruction (section 4.4.4). 


Use of R= augments macro definitions and increases optimization of object code. It is illegal in a 
PPU program. 


The A list option controls listing of substituted instructions. 
Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

sym 

R= 

reg,exp 


sym Optional, if present, sym is assigned the value of the location counter after 

the force upper occurs. This force upper occurs whether the R= generates an 
instruction or not. 
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reg 

exp 


Examples 

1 . 


A register designator (A, X, or B) and a digit (0-7) vvliich COMPASS 
concatenates with S to form the instruction opei^ation code. 

Operand register or value expression. If exp is the same two characters 
as reg, no instruction is generated. 

If the ejqDression value is 0, the variable field is BO. 

If the Bl=l instruction has been assembled prior to this instruction and the 
expression value is 1, 2, or -1, the vainable field of the instruction is Bl, 
Bl+Bl, or-Bl, respectively. 

If the B7“l instruction has been assembled prior to this instruction and the 
expression value is 1, 2, or -1, the variable field for the instruction is B7, 
B7+B7, or-B7, respectively. 

In all other cases, the variable field is the register or value indicated by the 
expression. 


used with Bl-1 


Code Generated 


LOCATION 

OPERATION 

VARIABLE COMMENTS 


I 


\) 

IB 1 30 



PI -1 

P- 

"P r .. 

-1- 

1 

'1 


used with 


Code Generated 


LOCATION 

OPERATION 

VARIABLE COMMENTS 


1 


n 

ID i30 



TAH 

P = 

X5,-1 1 

j 7150777776 ':; 



;sx5 '' 
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3. Expression is same as register designator: 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


11 

IB 

ho 




. .. 


PFG 

MICRO 

.R.?... 

, JtREG* .. ! 

B5,B5 rr:-' ■ 


No instruction is generated; SB5 B5 would be a no operation instruction- 

4.8.8 REP, REPC, AND REPI - GENERATE LOADER REPLICATION TABLE 

The REP, REPC, and REPI instructions cause the assembler to generate an REPL loader table so 
that when the subprogram being assembled is loaded, the loader will load one or more copies of a 
data sequence- For the REPI instruction, the loader generates the copies Immediately upon encoun¬ 
tering the table; for REP, the replication taJces place at the end of loading. For REPC^'the loader 
ignores the REPL table if the destination data address is in a common block that \\ as first declared 
by a previously loaded subprogram; otherwise, the loader generates the copies immediately upon 
encountering the tables. 

Replication of object code is valid in relocatable assemblies only. It is particularly useful for setting 
one or more blocks of storage to a given series of values or for generating tables. 

Data to be replicated must not contain any external references or common block relocatable addresses. 
For REPC and REPI, data must be in previously assembled text. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFitLDS 


REP 

IIEPC + 

REPI 

S/saddr, D/daddr, C/rep,B/bsz, I/inc 


A location field symbol, if present, is ignored- 

The variable field subfields can be in any order. 

S/saddr Relocatable expression specifying first word address of code to be copied. 

The S/saddr sub field must be provided. If it is zero, or omitted, the assembler 
flags the instruction as erroneous and does not generate an tlEPL loader tabic. 

D/daddr Relocatable exi:)ression specifying the destination of the first word of the first 

copy. If D/dacldr is omitted, the assembler sets daddr to z.ero, and, when 
daddr is zei'o, the loader uses saddr plus bsz for the destination address. 

Note that room for the repeated data must be reserved in the destination block. 


Not supported by SCOPE 2 Loader. 
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C/rep 


B/bsz 


I/inc 


Absolute expression specifying the number of times code is to be copied. When 
base is M, COMPASS assumes that rep is a decimal value. If C/rep is 
omitted, the assembler sets rep to zero. When rep is zero or one, the loader 
makes one copy. 

Absolute expression specifying the number of words to be copied (block size). 
When base is M, COMPASS assumes that bsz is decimal. 

If B/bsz is omitted, the assembler sets bsz to zero. When bsz is zero or one, 
the loader copies one word. 

Absolute expression specifying the increment size in words. When base is M, 
COMPASS assumes that inc is in decimal. 


The increment size is the number of words between the first word of each copy. 
When inc is zero or omitted, the loader uses bsz as the Increment size. The 
loader writes the first copy starting at daddr, the second starting at daddr+inc, 
the third at daddr + 2 x inc, etc. until the rep count is exhausted. 

The origin and location counters for the block containing the daddr are not advanced by a value of 
inc X rep. Storage reservation for replicated code is the responsibility of the user. 


Rules for replication; 

1. The S subfield cannot be omitted 

2. Room must be reserved for the copies in the destination block (for example, through 
ORG, ORGC, or BSS) 

3. REP, REPC, and RE PI can be used in relocatable assemblies only 

4. Data to be replicated must not contain any external references or common block relocatable 
addresses 

5. For REPC and REPI, data must be in previously loaded text 


Example: 


Location 

Code Generated 

1 

LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


11 

IB ho 

“ 





■ " "r 


10 


Pp 


10 





USE 

NFWP ; 

*5017 

oaDnooDCOGOcoononoi? 


PA 

DATA 

15,?a,7D7QP,1,5,3.14 


nnooooonnooGoooDDOZO 




1 

*50?! 

00000000000000007070 






QOQOOQDPQOOOOOnOOOOl 




1 

«50?3 

0000000^000000000005 




1 

^024 

17216300000000000000 




1 


13 


I 

FQU 






USE 

nnLPPK 1 

‘5 251 



DA 







USE 

♦ 1 





PPPT 

S/nA,G/nA,P/I-5,C/RC,I/T 
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4.9 CONDITIONAL ASSEMBLY 


The following pseudo instructions permit optional assembly or skipping of source code. A special form, 
SKIP, causes unconditional skipping. COMPASS provides IF test instructions that: 

Test for assembly environment (IFtype) 

Compare values of two e 3 q)ressiona (IFop) 

Compare values of two character strings (IFC) 

Test the attribute of a single symbol or an expression (IF) 

Test the sign of an expression (IFPL and IFMI) 


Immediately following the test instruction are instructions that are assembled when the tested condition 
is true and skipped when the condition is false. Skipping is terminated either by a source statement 
count on the IF instruction, or by an ENDIF, an ELSE, or an END. 

The statement count, when used, is decremented for instruction lines only; comment lines (identified by 
* in column one) are not counted. Etetermining the IF range with a statement count produces slightly 
faster assembly than using the ENDIF. 

The results of an IF test are determined by the values of expressions in pass one; the value of a 
relocatable symbol is relative to the USE block in which it was defined. The value of an external S 3 rtnbol 
is 0 if the symbol was declared as external. If the symbol was defined relative to a declared external, 
the value is the relative value. 


4.9.1 ENDIF--END OF IF RANGE 

An ENDIF causes skipping to terminate and assembly to resume. When the sequence containing the 
ENDIF is being assembled, or is controlled by a statement count, the ENDIF has no effect other than 
to be included in the coimt. 

Skipped instructions such as macro references are not expanded. Thus, any ENDIF that would have 
resulted from an expansion is not detected. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

ifiiame 

ENDIF 



ifname Name of an IF, SKIP, or ELSE sequence; or blank. Lfname can be used as any 

other type of symbol elsewhere in the program. 

Skipping of a sequence initiated by an IF, SKIP, or ELSE that is assigned a name can be terminated 
by an ENDIF specifying the sequence by name, or by any unnamed ENDIF. Any ENDIF terminates 
skipping of an unnamed sequence that is not controlled by a source line count. A named ENDIF 
terminates the named IF, SKIP, or ELSE and any unnamed IF, SKIP, or ELSE sequences in effect 
that are not under line count control. 
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4.9.2 ELSE - REVERSE EFFECTS OF IF 

Through the ELSE instruction, COMPASS provides the facility to reverse the effects of an IF test 
within the IF range. An ELSE detected during skipping causes assembly to resume at the instruction 
following the EI5E. An EI£E detected while a sequence is being assembled initiates skipping of source 
code following the ELSE. Scipping continues until: 

1. A statement coimt specified on the ELSE is exhausted 

2. A second ELSE is detected for the sequence 

3. An ENDIF is detected for the sequence 


Format: 


LOCATION 

OPERATION 

VARIABLE SUfiPlElDS 

ifiiame 

ELSE 

JUnct . 


ifname Name of an IF, SKIP, or ELSE sequence, or blanlc. 

j0act Optional absolute evaluatable expression specifying integer number of source 

lines to be skipped. It has no effect if the ELSE resumes assembly. When the 
base is M, COMPASS assumes that fnct is decimal. 

An ELSE specifying the sequence by name or any unnamed ELSE terminates skipping of a sequence 
initiated by an IF, SIOP, or an ELSE that has an assigned name. Skipped instructions such as macro 
references are not expanded; any ELSE that would have resulted from the expansion is not detected. 


4.9.3 IFTYPE - TEST OBJECT PROCESSOR TYPE 

IFtype pseudo instructions test for the type of processor that will execute the object program, as 
declared by MACHINE, and PERIPH or PPU pseudo instructions. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 

ifname 

IFlype 

£act 
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Optional 1-8 character name. 

Mnemonic specifying type of object processor. 

Type Condition Causing Assembly 

CP Any central processor unit 

CP6 Neither PERIPH nor PPU nor MACHINE 7 has been specified. CPU code is 

assembled for a CYBER 180 Series, a CYBER 170 Series, CYBER 70/Model 71, 
72, 73, or 74, or 6000 Series Computer System. 

CP7 Neither PERIPH nor PPU nor MACHINE 6 has been specified. That is, CPU 
code is assembled for a CYBER 70/Model 76 or a 7600 Computer System. 

PP Any peripheral processor unit 

PP6 One of the following is true: 

1. PERIPH has been specified but MACHINE 7 has not been specified. 

2. PPU and MACHINE 6 have both been specified. PPU code is assembled 
for a CYBER 180 Series, a CYBER 170 Series, CYBER 70/Model 71, 72, 
73, or 74, or a 6000 Series Computer System. 

PP7 One of the following is true: 

1. PPU has been i^ecified but MACHINE 6 has not been specified. 

2. PERIPH and MACHINE 7 have both been specified. That is, PPU code is 
assembled for a CYBER 70/Model 76 or a 7600 Computer System. 

f net Optional absolute evaluatable expression specifying an integer count of the number of 

statements to be skipped. When base is M, COMPASS assumes that fnct is decimaL 

The ifname and fnet parameters are related as follows: 

1. If a count is supplied, it takes precedence over any ENDEF but not over an ELSE. The only effect of an 
ENDIF in a count controlled sequence is to be included in the count. Skipping terminates when the 
count is exhausted or when an ELSE with a matching or blank name is encountered, whichever occurs 
first 

2. If neither a count nor a name is supplied, the IF range is terminated by an ENDIF, whether named or 
unnamed, or by a unnamed ELSE, whichever is encountered first. A named ELSE has no effect. 


ifname 

type 


60492600 L 


4-61 









3. If a name but no count is supplied, the IF range is terminated by an ENDIF or ELSE with a 
matching name or by an unnamed ENDIF or ELSE. An ENDIF or ELSE with a name that 
does not match has no effect. 


Example: 


Code Generated 

— 

LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


n 

IB 

|30 




TTENT 

MACHINE 

• 

XY2 

6 

i 

1 

1 

Q13Q0QQQ0G 



• 

ass 

IFCP^ 

XJ 

ELSE 

MJ 

1 

123 

? 

G 

1 

0 

1 

1 

i 

1 

1 

1 


4.9.4 IFOP-COMPARE EXPRESSION VALUES 

An IFop pseudo instruction compares the values of two expressions according to the relational 
mnemonic specified and assembles instructions in the IF range when the comparison is satisfied. 


Format: 


LOCATION 

OPERATION 

VARIABLE SUBF1E105 

ifaaxne 

IFop 

exp^, expg.jtoct 


if name Optional 1-8 character name 

op ^ecifies comparative test: 

op Condition causing assembly 

EQ Equality, the expressions are equal in all respects. That is,they 

not only have the same numeric value but have the same attributes 
as well. For example, both are names that are common 
relocatable, or absolute, or external, etc. 

NE Inequality, the expressions are not equal in all respects. They 

differ in value or in some attribute. 

GT The first expression is greater in value than the second expression. 

No other attributes are tested. 
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GE The first expression is greater than or equal in value to the second 

expression. No other attributes are tested. 

LT The first expression is less in value than the second expression. 

No other attributes are tested. 

LE The first expression is less than or equal in value to the 

second expression. No other attributes are tested. 

For these tests, positive zero and negative zero are equal. 

exp. An expression. When the value of exp is tested, exp can include only previously 

defined symbols and the result can be absolute, relocatable, or external. If an 
undefined S3mibol is used, the expression value is set to zero, the IF instruction 
is flagged as erroneous, and assembly continues with the next instruction. 

fnct Optional absolute evaluatable expression specifying an integer count of the 

number of statements to be skipped. When base is M, COMPASS assumes 
that fnct is decimal. When jdnct is blank, the comma can be omitted. 

The ifname and fnct parameters are related as follows: 

1. If a count is supplied, it talces precedence over any ENDIF but not over an ELSE. The only 
effect of an ENDIF in a count controlled sequence is to be included in the count. Skipping 
terminates when the count is exhausted or when an ELSE with a matching or blank name is 
encountered, whichever occurs first. 

2. If neither a count nor a name is supplied, the IF range is terminated by an ENDIF, whether 
named or unnamed, or by an unnamed ELSE, whichever is encountered first. A named ELSE 
has no effect. 

3. If a name but no count is supplied, the IF range is terminated by an ENDIF or ELSE with a 
matching name or by an unnamed ENDIF or ELSE. An ENDIF or ELSE with a name that 
does not match has no effect. 

Example: 

A demonstration of one use of IF statements in a PPU program: 



This code assembles a zero jump to the symbol LOOP if LOOP has been defined within 37 words (the 
range of a short jump) prior to the occurrence of this code. Otherwise, the NJN and LJlViare assembled. 
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4.9.5 iFPL AND IFMI -TEST SIGN OF EXPRESSION 

The IFPL anH IFMI pseudo instructions test the sign of an expression and assemble instructions in 
the IF range according to whether the sign of the value is plus (PL) or minus (MI). The pseudo 
instructions allow positive zero to be distinguished from negative zero. 


Format: 


LOCATION 

OPERATION 

VARIABLE SUQFIELDS 

ifname 

IFPL 

exp, met 

ifiiame 

IFMI 

exp, met 


ifname Optional 1-8 character name 


An expression. It can include only previously defined symbols and the result 
can be absolute, relocatable, or external. If an undefined symbol is used, the 
instruction is flagged as erroneous and assembly continues with the next 
instruction. 

Optional absolute expression specifying an integer count of the number of 
statements to be sldpped. When base is M, COMPASS assumes that fnct is 
decimal. When met is blank, the comma can be omitted. 


The ifname and met parameters are related as follows: 

1. If a count is supplied, it talces precedence over any EKDIP but not over an ELSE, The only 
effect of an ENDIF in a count controlled sequence is to be included in the count. Skipping 
terminates when the count is exhausted or when an ELSE with a matching or blanlc name is 
encountered, whichever occurs first, 

2. If neither a count nor a name is supplied, the IF range is terminated by an ENXHF, whether 
named or unnamed, or by an unnamed EIEE, whichever is encountered first. A named ELSE 
has no effect. 

3. If a name but no count is supplied, the IF range is terminated by an ENDIF or ELSE with a 
matching name or by an unnamed ENDIF or ELSE. An ENDIF or ELSE with a name that does 
not match has no effect. 

The condition tested for by IFPL is satisfied if the value of exp is greater than or equal to plus zero; 
the condition for IFMI is satisfied if the value of exp is less than or equal to minus zero. 
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Example: 


The following opdef defines the CPU instruction MXi jk so that the address value is 60 if the expression 
value is negative zero or a positive non-zero multiple of 60, otherwise it is the address expression 
value modulo 60. 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

\ 


11 

18 lao 


HXQ 

OPOEF 

REG,VAL ! 



LOCAL 

A 1 


A 

SET 

VAL 1 


A 

SET 

A-A/6<JO*60n* 



IFPL 

A,3 1 



IFEQ 

A f j 9 3 1 



IFLE 

VALfOtl 



s<rp 

1 1 


A 

SET 

A4^60D I 



VFD 

6/43B»3/REG,6/A 



EHUn 

1 

1 


Example of call: 


Code Generated 


LOCATION 

OPERATION 

VARIAOIE COMMENTS 


1 


11 

18 lao 




NX6 

-52 i 

7777713 


t*oooooi 


SET -52 1 

7777713 


tAOOOOOl 

IFPL 

SET t4^000Q01-t 4000001 / 60 D*60D 

t4000001^3 




IFEQ 

t4000001 ^0,.3 




IFLE 

-52^0^1 




SKIP 

1 

10 


tAOOOOOl 


SET t4000001+600 

^*3610 



VFO 

ENDM 

1 

6/43B,3/6,,6/t4000D01 

1 

1 


4.9.6 IF - TEST SYMBOL OR EXPRESSION AHRIBUTE 


The IF pseudo instruction tests a symbol or an expression for a specific attribute and assembles 
instructions in the IF range if the test is satisfied. 
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Format: 


LOCATION 

OPEIATION 

VARIABLE SUBFiELDS 

ifoame 

IF 

att,e}qp,inct 

ifoame 

Optional 

1-8 character name 


att 

^ecifies attribute test* A minus prefix to the attribute causes assembly on 
the false rather than the true condition* 


att 

Condition causing assembly 


SET 

The symbol given in the second subfield was defined by a SET, 
MAX, MIN, or MICCNT 


-SET 

The symbol given in the second subfield was defined other than 
by a SET, MAX, MIN, or MICCNT 


ABS 

The expression in the second subfield reduces to a value that is 
not relocatable or external 


-ABS 

The expression in the second subfield reduces to either a 
relocatable or an external address 


REL 

The expression in the second subfield reduces to a local or 
common relocatable address 


-REL 

The expression in the second subfield does not reduce to a local 
or common relocatable address 


REG 

The expression in the second subfield contains one or more 
register names 


-REG 

The expression in the second subfield does not contain a register 
name 


COM 

The expression in the second subfield reduces to a common re¬ 
locatable address (any blanlc or labeled common block) 


-COM 

The expression in the second subfield is not a common relocatable 
address (any blanlc or labeled common block) 


EXT 

The expression in the second subfield contains one or more 
external symbols 


-EXT 

The expression in the second subfield does not contain an 
external symbol 


LCM 

The expression reduces to an LCM address 


-LCM 

The expression does not reduce to an LCM address 


LOG 

The expression reduces to a program relocatable address 


-LOG 

The expression does not reduce to a program relocatable address 
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DEF All the symbols in the expression in the second subfLeld are 

defined 

-DEF One or more of the symbols In the expression In the second 

sabfleld Is undefined 

MAC The name in the second subfield Is an opcode name 

-MAC The name in the second subfield does not contain an opcode name 

MIC The name in the second subfield is a micro 

-MIC The second subfLeld does not contain a micro name 

SST The second subfield contains a system symbol 

-SST The second subfleld does not contain a system symbol 

exp For SET, SST, -SET, and -SST, exp must be a single defined symbol. For 

MIC and -MIC, exp must be a name. For any other test, it is an expression. 
The expression can include symbols as yet undefined if att is DEF, -DEF, REG, 
-REG, EXT, or -EXT only. If an undefined symbol is used with any other 
attribute, the expression value is set to zero, the instruction is flagged as 
erroneous, and assembly continues with the next instruction. Note that If 
a symbol is never defined conventionally but only by use of -S or -X prefix 
(see section 2.4. 2), COMPASS does not define the symbol until the end of 
the assembly, and IF tests will consider the symbol undefined, 

£nct Optional absolute evaluatable expression specifying an integer count of the 

number of statements to be skipped. When base is M, COMPASS assumes 
that fnct is decimal. When fnct is blank, the comma can be omitted. 

The ifname and fnct parameters are related as follows: 

1. If a count is supplied, it takes precedence over any ENDIF but not over an ELSE. The only 
effect of an ENDIF in a coimt controlled sequence is to be included in the count. Skipping 
terminates when the count is exhausted or when an ELSE with a matching or blank name is en¬ 
countered, whichever occurs first. 

2. If neither a count nor a name is supplied, the IF range is terminated by an ENDIF, whether 
named or unnamed, or by an unnamed ELSE, whichever is encountered first. A named ELSE 
has no effect. 

3. If a name but no count is supplied, the IF range is terminated by an ENDIF or ELSE with a 
matching name or by an unnamed ENDIF or ELSE. An ENDIF or ELSE with a name that does 
not match has no effect. 
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Examples 



4.9.7: IFC - COMPARE CHARACTER STRINGS 

The IFC pseudo instruction compares two character strings according to the operator specified 
and assembles instructions in the IF range if the comparison is satisfied. 

Format; 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

ifnamfi 

IFC 

op, dstringj^dstring 2 d, i[nct 



ifname Optional 1~8 character name 

d Delimiting character. Characters between the first and second occurrence of this 

character constitute the first character string; characters between the second and 
third occurrence constitute the second character string. 

op ^ecifies comparative test: 


op 

Condition causing assembly 

EQ or -NE 

stringy has the same value as stringy 

NE or -EQ 

stringy does not equal stringy 

GT or -LE 

string is greater than string 

I 2 
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GE or -LT 


stringj^ is greater than or equal to string 

A 

LT or -GE stringy is less than string 2 

LE or -GT string]^ is less than or equal to stringg 

string. Character string. When IFC is within a macro definition, each character string 

can be a formal parameter. 

Jtoct Optional absolute evaluatable expression specifying an integer count of the number 

of statements to be skipped. When base is M, COMPASS assumes that ^nct is 
decimal. When fnct is blanlc, the comma can be omitted. 

The ifname and j&ict parameters are related as follows: 

1. If a count is supplied, it takes,precedence over any ENDIF but not over an ELSE. The only 
effect of an ENDIF in a count controlled sequence is to be included in the count. Skipping 
terminates when the count is exhausted or when an ELSE with a matching or blank name is 
encountered, whichever occurs first. 

2. If neither a count nor a name is supplied, the IF range is terminated by an ENDIF, whether 
named or unnamed, or by an unnamed ELSE, whichever is encountered first. A named ELSE 
has no effect. 

3. If a name but no count is supplied, the IF range is terminated by an ENDIF or ELSE with a 
matching name or by an unnamed ENDIF or ELSE. An ENDIF or ELSE with a name that does 
not match has no effect 

Each character in stringy is compared with the corresponding character in string 2 progressing from 
left to right until an inequality is found or both strings are exhausted. When one string is shorter than 
the other, it is padded with a character that has a value less than any other character in the string. 

The truth condition is based on the relative magnitudes of the characters in the strings. 

Examples: 



LOCATION 

OPERATION 

VARtAeiE 

COMMENTS 

1 


11 

IB 

30 


TFSTl 

IFC 

EQi^ABCSABCi 

ABC EQUALS ABC 


TEST2 

IFC 

LT,*AB*ABC* 1 

1 AB IS LESS than ABC 


TEST3 

IFC 

GT.XAXX 1 

, A IS GREATER THAN NULL 



IFC 

-Ge,*Z*8*,3 1 

Z IS LESS THAN 0 


The IFC in the following example checks for an empty parameter string. 
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LOCATION 

OFERATION 

VAKIABLE 

COMMENTS 

1 


U 

Ifi 

iao 


XX 

MACRO 

P1,P2 

-i— 


IFC 

FQ,^*P2*fl 

1 


p 

ERR 

• 

• 


' FLAG EPROP 


1 

ENDM 




The following example illustrates a character string terminated incorrectly'. When COMPASS reaches 
end of statement without finding a third asterisk, the asterisk omitted following PI causes an error flag. 


— 

LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


M 

IS 130 



IFC 

EQ.’OD^PltZSPZ 


4.9.8 SKIP - UNCONDITIONALLY SKIP CODE 

The SKIP instruction causes COMPASS to unconditionally skip the instructions in the SKIP range. 
It resembles an IF for which there is no true condition. 

Format 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

ifname 

SKIP 

jtnet 


ifname Optional 1-8 character name 

j2nct Optional absolute evaluatable expression specifying an integer count of the number 

of statements to be skipped. When base is M, COMPASS assumes that jgnct is 
decimal- 

The ifname and Xnct parameters are related as follows: 

1. If a count is supplied, it talees precedence over any ENDIF but not over an ELSE. The only 
effect of an ENDIF in a count controlled sequence is to be included in the count. Skipping 
terminates when the count is exhausted or when an ELSE with a matching or blank name is 
encountered, whichever occurs first. 
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2. If neither a count nor a name is supplied, the SKIP range is terminated by an ENDIF, whether 
named or unnamed, or by an unnamed ELSE, whichever is encountered first. A named ELSE 
has ho effect. 

3, If a name but no count Is supplied, the SKIP range Is terminated by an ENDIF or ELSE with 
a matching name or by an unnamed ENDIF or ELSE. An ENDIF or ELSE with a name that 
does not match has no effect. 


4.10 ERROR CONTROL 

The ERR and ERRxx pseudo instructions described in this section either conditionally or unconditionally 
set an error flag- 


4.10.1 ERR - UNCONDITIONALLY SET ERROR FLAG 

An ERR pseudo instruction produces an assembly error but does not affect other code. Usually, it is 
used in conjunction with a conditional assembly pseudo instruction to force an error into the assembly 
based on an assembly time test. One application is to use a test and ERR to detect illegal macro 
parameters. 


Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIOS 

flag 

ERR 



flEig A single alphanumeric character denoting the error type. The flag is placed 

in the listing to the left of the line for ERR. The flag can denote a fatal or 
nonfatal error. A fatal error causes COMPASS to suppress generation of the 
binary deck unless the D mode option is selected on the COMPASS control 
card. If no flag is specified, or the character is not one of those given in 
section 11.7, COMPASS uses P. 

A variable field entry, if present, is ignored. 


Example: 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


11 

IS (30 


NNN 

MACRO 

Pl,P0,P3,P4l 



IFEQ 

Pl.O 1 


A 

ERR 

t 



• 

1 

• 



• 

• 1 



■ 

• 1 



ENOH 

1 



m 

• 1 



m 

• 1 



m 

• 1 



NNN 

0 f A f Bf C ' 
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4.10.2 ERRxx--CONDITIONALLY SET ERROR FLAG 


An ERRxx pseudo instruction produces an assembly error when a condition detected during the second 
pass of the assembler is true. 

Format: 


LOCATION 

OPERATION 

VARIAIIE SUBFIELDS 

flag 

ERHxx 

aexp 


flag A single alphanumeric character denoting the error type. The flag is placed 

in the listing to the left of the line for ERR. The flag can denote a fatal or 
nonfatal error. A fatal error causes COMPASS to suppress generation of the 
binary deck unless the D mode option is selected on the COMPASS control card. 
If no flag is specified, or the character is not one of those given in section 11.7, 
COMPASS uses P. 

XX Defines condition under which aexp value is erroneous. 


XX 

NG or MI 
NZ 
PL 
ZR 


Error Condition 
Value of expression is negative 
Value of expression is nonzero 
Value of expression is positive 
Value of expression is zero 


aexp Absolute expression. It cannot contain external symbols or references to blank 

common. The test is made in pass two of the assembler. Relocatable addresses 
are assigned values relative to program origin rather than to the block in which 
they are defined. 


NOTE 

ERRxx is the only conditional instruction for which the 
test is made in pass two. Therefore, this is the only 
pseudo instruction that can be used to determine PPU 
overflow if the PPU program has literals and USE 
blocks. 

Example: 


Test for memory overflow in PPU assembly 


Location Code Generated 


LOCATION 

OPERATION 

VARIABLE COMMENTS 

7hkr 

7777447 

7462 ‘ 

1 


11 

IB |30 


LASTTAG 

R 

PERIPH 

« 

• 

BSS 

ERRPL 

END 

. —-r - 

I. 

, 1 

LASTTAG-7777j 

1 
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4.11 LISTING CONTROL 

The instructions described in this section permit extensive control of the assembly listing format. 


4.11,1 LIST - SELECT LIST OPTIONS 

The LIST pseudo instruction controls the content and format of the assembler listing. LIST instructions are 
disabled under either of the following conditions: 

When the list parameter (L) on the COMPASS control statement (chapter 10) is zero, or 

When the list option parameter (LO) on the COMPASS control statement is used and is other than 
LO=0. 


Use of the LIST pseudo instruction is optional. If it is not used in the subprogram, COMPASS list output is 
according to the L and LO parameters on the COMPASS control statement. If the LO parameter is omitted 
or LO=0, the list options are as if L, B, N, and R only are selected and the listing contains heading 
information, assembly text, assembler statistics, an error directory (upon occurrence of an error only), and 
a symbolic reference table. Formats of this output are described in detail in chapter 11 and brief 
summaries are given below. 

Heading Information Program length, origin, and length or each block, entry points and 

external symbols. 

Assembly text Line, and assembly results of each line assembled (not skipped) 

from the input device (excludes code generated by RMT, DUP, 
ECHO, XTEXT, or a macro or opdef expansion). For data 
generating pseudo instructions DATA, DIS, BSSZ that produce more 
than one word of object code, only the first word is listed. For 
VFD and CON all words of object code are listed. For R=, only the 
pseudo instruction listed. 

Each occurrence of the LIST instruction is listed. 

Assembler statistics Amount of storage used, counts of assembled statements, defined 

symbols, invented symbols, and references to symbols. 

Error directory List of fatal and nonfatal errors and summary of the causes of each. 

Symbolic reference table List of all symbols defined in the program according to symbol 

qualifier, if any, followed by an index to every reference to the 
symbol, whether in explicit or generated (for example, by MACRO 
or MICRO calls) statements. 


Formats: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


LIST 

op2 


or 



LIST 

* 
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A location field symbol, if present, is ignored. 

op. A list option represented by a single letter or a letter prefixed by a minus sign. 

^ The unprefixed letter selects the option; the prefixed letter cancels the option. 

Options are separated by commas and terminated by a blank. 

A List statements actually assembled 

When A is not selected, a line containing concatenation and micro substi- 
tuticHi marks is listed with the marks in it exactly as presented to the 
assembler. When the A cation is selected, however, the assembler lists 
the line before and after the editing takes place. Selecting A also causes 
the listing of lines of code resulting from the R== pseudo instruction. 

B List binary control statements 

When B is selected, the listing Includes SEG, SEGMENT, ID ENT, and 
END pseudo instructions, 

C List listing control statements 

When C is selected, the listing includes EJECT, SPACE, TTL, and 
TITLE pseudo instructions. A listing instruction that causes an EJECT 
is listed as the first line of the new page after the EJECT takes place 

D Include details 

Selection of the D option causes listing of the following items not normally 
listed: 

Second and subsequent lines of DATA and DIS 

Code assembled remotely when HERE or END causes its assembly 
Literals block 
Default symbols 

E Include echoed lines 

Selection of E causes listing of all iterations of code duplicated as a result 
of DUP and ECHO. 

F List IF-skipped lines 

When F is selected, the listing includes all lines slapped by IF, IFop, 

IFC, IFPP, IFCP, SKIP, and ELSE. In addition, the ^mbolic Reference 
Table contains references to symbols in IF statements. 

G List generated code 

Selection of this option causes listing of all code generating lines regardless 
of list controls other than L. Instructions listed include symbolic machine 
instructions and BSS, BSSZ, CON, DATA, DIS, R=, and VFD. 

L Master list control 

This option is normally selected. When L is canceled, the long list contains 
error flagged lines, an error directory, and LIST and END pseudo instruc¬ 
tions only, regardless of selection of any other options on LIST, 

M List macros and opdefs 

Selection of M causes all lines generated by calls to macros and opdefs other 
than those defined by the system to be listed. 
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N List nonreferenced symbols 

This option Is normally selected. Cancellation of this option causes 
any nonsystem symbol for which no reference has been accumulated 
(e. g., all occurrences are In IF statements with the F option deselected, 
or are between CTEXT or ENDX with the X option deselected) to be 
omitted from the symbolic reference table. 

R Accumulate and List references 

This option is normally selected. When R is canceled, COMPASS does 
not accumulate references. R should not be canceled if a complete 
symbolic reference table is desired. If R is canceled at the end of 
assembly, no symbolic reference table is produced. 

S List systems macros and opdefs 

Selection of S causes all lines generated by calls to systems-defined 
macros and opdefs to be listed. 

T List nonreferenced system symbols 

Selection of this option causes a symbol defined through SST to be 
included in the symbolic reference table even if there are no accumulated 
references. 

X List XTEXT lines 

Selection of the X option causes listing of all statements assembled as a 
result of an XTEXT pseudo instruction. CTEXT and ENDX provide a 
means of alternately turning this external designator off and on. 

$ A dollar sign in the variable field selects all options. 

* An asterisk in the variable field causes selection of the options in effect prior 

to the current selection. The assembler records occurrences of LIST pseudo 
instructions and maintains a table of the most recent 50 occurrences. Each 
LIST * resumes use of the most recent entry and removes it from the list. 

When the subprogram contains more LIST * instructions than there are entries 
in the stack, COMPASS selects the default list options (B, L, N, and R). 

For list options A, C, D, E, F, M, S, and X, all applicable options must be selected for a specific 
line to be listed. For example, listing of an expansion resulting from a DUP within a macro requires 
selection of both M and E. Similarly, an expansion caused by an XTEXT within a system macro call is 
listed only when both X and S are selected. To obtain a listing showing pand marks removed from 
external text inside a DUP range. A, X, and E must all be selected. 

Example: 




LOCATrON 

OPERATION 

VARIABIE COMMENTS 


1 


11 

IB ho 




LIST 

A 1 




OATA 

l.Si^EE [ 

a 17Za51463t4631463i<«6 



DATA 

1.3EE ' 




Liyr 

D 1 




UAfA 

1.3i^££ 1 

2 17205146314631463146 



DATA 

1 •3EE 1 

3 16403146314631463146 








LIST 

-A,-D 1 

4 17205146314631463146 



OAI A 

l.SfEE 1 




LIST 

♦ 




OATA 


6 17205146314631463146 



DATA 

1.3EE 

7 16403146314631463146 




1 
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4.11.2 EJECT—EJECT PAGE AND BEGIN NEW SUB-SUBTITLE 

The EJECT pseudo instruction advances printer paper to a new page before printing. Then, page 
headings are printed and listing continues. EJECT has no effect, other than setting the sub-subtitle, 
if it is generated by DUP, ECHO, RMT, XTEXT, or a macro or opdef expansion, and the cor¬ 
responding LIST options are not all selected. 

Format; 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

name 

EJECT 



name New program sub-subtitle for the page will be printed in character positions 

70-79 of the second line of the page. A blank name clears the sub-subtitle. 

An entry in the variable field, if present, is ignored. 


4.11.3 SPACE-SKIP LINES AND BEGIN NEW SUB-SUBTITLE 

The SPACE pseudo instruction spaces the assembler listing. When a page is full, an eject occurs 
^r\d listing resumes on the next page. A SPACE immediately following an EJECT is ignored. SPACE 
has no effect, other than setting the sub-subtitle, if it is generated by a DUP, ECHO, RMT, 
XTEXT, or a macro or opdef expansion, and the corresponding LIST options are not all selected. 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

name 

SPACE 

sent, rent 


name New subprogram sub-subtitle will be printed in characters 70-79 on the second 

line of the next page heading. A blanlc name clears the sub-subtitle. 

sent An absolute expression specifying a positive integer number of spaces between 

the most recent line and the next line of printout. If base is M, sent is assumed 
to be decimal. If sent is omitted or zero, no line is skipped. 

rent An absolute expression specifying a positive integer number of lines that must 

be remaining on the page following spacing. If base is M, rent is assumed to 
be decimal. 

If sent + rent exceeds the number of lines on the page before spacing occurs, the SPACE acts like an 

EJECT, Note that either the eject occurs or the number of spaces are skipped but not both. 

Blank cards or statements can also be used to space the listing. 
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4.11.4 TITLE - ASSEMBLY LISTING TITLE 

The first TITLE pseudo instruction establishes the title that will be printed on each page of the listing, 

A subsequent TITLE instruction generates a subtitle and causes a page eject. If the subprogram does not 
include a TITLE instruction^ COMPASS prints the variable field of the first ID ENT pseudo instruction 
as the title, A TITLE instruction without a character string produces an untitled listing, A name in 
the location field introduces a new subprogram sub*-sub title. 

A TITLE instruction has no effect when LIST option X is deselected and the TITLE instruction is 
In text read by XTEXT or is between CTEXT and ENDX instructions. All other TITLE instructions 
(except the first which sets the main title) cause a page eject, even when generated by a macro 
expansion, unless LIST option L is deselected. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIOS 

name 

TITLE 

string 


name New subprogram sub-subtitle to be printed in character positions 70-79 

on the second line of the page, A blanlc name clears the sub-subtitle. 


string COMPASS searches the columns following the blanlc that terminates the 

operation field. If it does not find a nonblanic character before the default 
comments column (see COL pseudo instruction), it takes the characters 
starting with the default comments column minus one up to the end of the 
statement. Otherwise, the title or subtitle begins with the first nonblanic 
character following TITLE and continues to the end ‘of the statement or to 
62 characters. Any characters beyond the 62nd are lost. A blanlc string 
produces an imtitled listing. 


Example: 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

I 


IT 

IB |3Q 



lUENT 

MTO ! 



LIST 

C 1 



TITLE 

MT QRIVER 1 



• 

1 

1 



• 

1 

1 



• 

1 



TITLE 

I/O ROUTINESi 



• 




• 

1 



• 



60492600 H 


4-77 










• First page: 


MT DRIVER 


Subsequent pages: hT DRIVER 

I/O ROUTINES 

4.11.5 TTL-NEW ASSEMBLY LISTING TITLE 

The TTL pseudo instruction introduces a new main title to be printed on each page of the listing, and 
clears the subtitle. 

Format; 


LOCATION 

OPESATION 

VARIABLE SUDFIELDS 

name 

TTL 

string 


name New sub-subtitle to be printed in character positions 70-79 on the second 

line of the pages. A blank name clears the sub-subtitle. 

string COMPASS searches the columns following the blank that terminates the operating 

field. If it does not find a nonblanlc character before the default comments column 
(see COL pseudo instruction), it talces the characters starting with the default 
comments column minus one up to the statement end. Otherwise, the title begins 
with the first nonblank character following TTL and continues to the end of the 
statement or to the 62nd character. Any characters beyond the 62nd are lost. 

A blank string produces an untitled listing, 

TTL does not cause a page eject. 


4.11.6 NOREF-OMIT SYMBOL REFERENCES 

The NOREF pseudo instruction causes the symbols named in the variable field to be suppressed from 
the symbolic reference table. 


Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIOS 


NOREF 

synij.synig.sym^ 


sym. One or more symbols defined in the subprogram. If a symbol qualifier is in 

^ effect when the NOREF is encountered, the symbols are assumed to be 

qualified by the qualifier in use, unless an unqualified symbol of that name 
is defined before the NOREF and the qualified symbol is not defined before 
the NOREF. Alternatively, sym. , can be a nonblanlc qualifier symbol en¬ 
closed by slant bars, /qualifier/l in which case all symbols qualified by 
the specified qualifier are suppressed from the symbolic reference table. 

A location field symbol, if present, is ignored. 
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4.11.7 CTEXT AND ENDXDISABLE/ENABLE LISTING OF COMMON DECK TEXT 

The CTEXT pseudo instruction sets the XTEXT flag for list control. 

NOTE 

When the flag is set, external text is listed and symbol 
references are recorded, only If the X list option is selected. 


Format: 


LOCATJON 

OPEKATION 

VASIABLE SUBFIEIDS 

name 

CTEXT 

string 


name If X list option is selected, name Is treated as a sub--sub title; other¬ 

wise it is ignored. 

string' If the variable field is nonblanlc and the X list option is selected, the CTEXT 

is treated as a subtitle. The CTEXT instruction generates a subtitle and 
causes a page eject. If X is not selected, the CTEXT does not affect titling. 

The subtitle begins with the first nonblank character following CTEXT 
or in the default comments column (see COL pseudo instruction) minus 
one, whichever comes first, and continues to the end of the statement 
or to 62 characters. Any characters beyond the 62nd are lost. 

The ENDX pseudo instruction clears the XTEXT flag for list control and causes listing to resume, 
starting with the instruction after ENDX, when the X list option has not been selected. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELOS 


ENDX 



Entries in the location field or variable field, if present, are ignored. 
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4.11.8 XREF—REFERENCE SYMBOLIC ADDRESS 


The XREF pseudo instruction provides the options of having the symbolic reference table contain 
references to symbols according to (1) location counter address, (2) page and line number, or (3) both. 
For the format of the symbolic reference table, refer to section 11.8. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELOS 


XREF 

string 


string An optional character string, the first character of which indicates how symbols 

are to be referenced. 

A The symbolic reference table lists addresses only. Flags are not included. 

B The symbolic reference table lists references to symbols according to 
page number, line, and address. Flags are included. 

P The symbolic reference table lists references to symbols according to 
page and line numbers. Flags are included. 

A location field symbol, if present, is ignored. 

If the string is omitted or if no XREF is issued, the symbolic reference table contains references 
according to page and line numbers and includes flags. The last XREF encountered in a subprogram 
determines the form of the listing for the entire subprogram. 
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DEFINITION OPERATIONS 


5 


This chapter describes pseudo instructions that involve definition operations. These pseudo instructions 
cause sequences of instructions to be saved for these reasons: 

They can be assembled from an external source (XTEXT), 

Assembly can be delayed until later in the subprogram (RMT). 

They can be assembled repeatedly (DUP and ECHO). 

They can be referred to for assembly (MACRO, MACROE or OPDEF). 

Any instructions other than END, including other definitions or calls, can be in the body of a definition. 

Each request for assembly of one of the saved sequences of code, such as a reference to a macro, causes an 
entry in the assembler recursion stack. The most recent entry in the stack points to the source of 
statements (the definition) to be assembled. When the definition contains an inner, nested, reference to a 
saved definition, the stack pointer is changed so that the source of statements is the innermost definition. 
The stack allows nesting of definitions to a maximum level of 400. When the end of a definition is reached, 
the assembler switches to the preceding entry in the stack. When the stack is empty, the assembly resumes 
assembly of the next statement in the input source deck. A nested definition must be wholly contained by 
its next outer definition. 

Definitions are saved compressed but otherwise unedited (with micro and concatenation marl<s). Editing 
occurs each time the definition is processed. Compression removes blanics and replaces them with coded 
bytes as follows; 

A single space is represented by 553 ; it is not compressed. Two or more embedded spaces are 
replaced in the image as follows: 

2 spaces replaced by SSSSg 

3 spaces replaced by 0002 

4 spaces replaced by 0003 


64 spaces replaced by OO 773 

65 spaces replaced by 0077553 

66 spaces replaced by 007755553 

67 spaces replaced by 007700023 , etc. 

Trailing spaces are considered as embedded and are included in the image. The 00 character (colon) is 
represented by the 12-bit code 0001. A 12-bit zero byte marics the end of the statement. 

The listing identifies the source of statements and the recursion level for all definition operations. 
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For XTEXT, DUP, and ECHO, assembly occurs as soon as a definition is saved. Unless the definition 
contains a USE, USELCM, or ORG instruction, code is assembled into the block in use when the XTEXT, 
DUP, or ECHO is encountered. For RMT, macros, and opdefs, however, definition and assembly take place 
in two steps. The block in use at definition time does not determine where code in the definition will be 
assembled. That is, code is assembled into the block in use when the definition is assembled if the 
definition does not itself contain a USE, USELCM, or ORG. 

Similarly, for XTEXT, DUP, and ECHO, any qualifier in effect when the pseudo instruction is encountered 
applies to symbols dehned in the sequence (assuming the sequence does not contain a QUAL). For RMT, 
macros, and opdefs, however, because definition and assembly take place in two steps, the qualifier in use 
at definition time does not affect symbols in the definition. The qu^fier, if any, in effect when the 
definition is assembled is applied to the symbols defined in the sequence, 

A qualifier appHes to symbols only. It does not apply to block names or to the names of DUP, ECHO, RMT, 
or macro definitions, nor to any substitutable parameter names. 

In definitions having substitutable parameters, it is not possible to use a different block name, different 
qualifier, or different symbols with each expansion simply by declaring either the qualifier symbol, block 
name, or symbols to be qualified as substitutable parameters. (For an examble, refer to example 7 under 
Macro Call.) 


5.1 EXTERNAL TEXT (XTEXT) 

The XTEXT pseudo instruction provides a means of obtaining source statements from a file other than that 
being used for input. COMPASS transfers the text from the external source and assembles it before taldng 
the next statement from the interrupted source of statements. The file may be a sequential file, a SCOPE 
3 indexed file with named records, or an UPDATE or MODEPyt random-access program library file. A 
sequential file is normal text and COMPASS will only read the first section. It is necessary to omit 
"rname^^ from sequential file usage, otherwise an error will occur. 

Random File Format; 


LOCATION 

OPERATION 

VARIABLE SUBFIEiDS 

file 

XTEXT 

mame 

(or) 



XTEXT 

rname 


tMODIFY is not supported by NOS/BE 1 and SCOPE 2. 
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Sequential File Format: 


LOCAHON 

OPERATION 

VARIA81E SUBFiElOS 

file 

XTEXT 

mame 

(or) 



XTEXT 



fUe Name of a file containing source statements. If file is omitted, COMPASS assumes the file 
named in the X parameter on the COMPASS control statement (section 10.1.2). If no X 
parameter was specified, COMPASS assumes OLDPL. 

rname If rname is blank, COMPASS assumes that the file is sequential; it rewinds the file and reads 
the first section. If rname is not blank, the file must be a SCOPE 3 indexed file with named 
records, a record indexed file with named records, a random-access program library file in 
UPDATE format, or a random-access program library file in MODIFY format. The rname 
parameter is the name of the section to be read. 
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Text records may be in any of the following formats: 

1. Normal text. If the first line contains rname starting in column 1, it is skipped. 

2 . A common deck in an UPDATE or MODIFY^ random-access program library file. If the tile 
is in UPDATE format, the first line (*COMDECK rname) is always skipped. If the file is in 
MODIFY format, the identification (7700) and modification (7702) tables are skipped. COMPASS 
does not recognize UPDATE or MODIFY directives such as *IF in the common deck. 

1 * 

3. An UPDATE or MODIFY' compressed compile file section. 

COMPASS reads source statements to an end-of-section mark or an END pseudo instruction. 


5.2 REMOTE ASSEMBLY 

Definition and assembly of remote code takes place in two steps. A pair of RMT pseudo instructions 
delimit code that is to be saved for later assembly. Later, a HERE pseudo instruction directs 
COMPASS to assemble a specific sequence of remote code or to assemble all unlabeled remote code. 
An END instruction causes any unlabeled remote code to be assembled. 


5.2.1 RMT-SAVE REMOTE CODE 

A RMT pseudo instructicn signals the beginning or the end of a sequence of code to be assembled 
remotely. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

rmtname 

RMT 



rmtname Optional 1-8 character name identifying the remote sequence. It is 

significant on the beginning RMT only. The field is ignored for a terminating 
RMT. If supplied, rmtname can be used on a subsequent labeled HERE. 

If the sequence is unlabeled, an unlabeled HERE or END causes its assembly. 

A variable field entry, if present, is ignored. 


Any instruction legal when the remote lines are called for assembly is legal between the RMT pair. 
If expansion of an RMT reveals a second RMT pair implicit to the saved definition, assembly of the 
first pair must occur through a HERE instruction so that the inner pair will be expanded by an END. 
Similarly, if the assembly of the second pair reveals yet a third RMT pair, the second pair must be 
assembled through a HERE rather than the END, etc. 

Any labeled remote code present when END is processed is discarded without notice. 


t 


MODIFY is not supported by NOS/BE 1 and SCOPE 2, 
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5.2.2 HERE-ASSEMBLE REMOTE CODE 


A HERE pseudo instruction causes the labeled remote sequence to be assembled or unlabeled saved 
remote sequences to be assembled. In the absence of a USE, USELCM, IDENT, or an ORG within 
the saved sequence, the remote code is assembled under the block in use at the time the HERE is 
encountered. In the absence of a QUAL within the saved sequence, symbols are qualified under the 
qualifier in use at the time the HERE is encountered. RMT code is assembled only once- After it 
is assembled, it is no longer saved. A HERE encountered when there is no remote text saved has no 
effect on assembly. 

Format: 


LOCATION 

OP£ilATlON 

VARIABLE SUSFlEiDS 

rmtname 

HERE 



rmtname Optional; the name of a previously saved RMT sequence. Only the named 

sequence will be assembled at this time. 

A variable field entry, if present, is ignored. 

If unlabeled remote sequences still remain to be assembled when the END statement signaling the end of 
assembly is encountered, COMPASS assembles them before it terminates assembly. However, any 
RMT pairs that might have resulted from the assembly are lost. Also, any remaining labeled remote 
code is lost. 

Examples: 

The following example illustrates use of RMT within a macro definition. Following the last call to 
the macro, a HERE causes all saved unlabeled RMT sequences to be assembled. 
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Location 


Code Generated 


4727 ? lo0060006600006632304 


4730 ., . . 

■ 1332 

4 73 0 0 0 0 0 6 0 0 0 0 0 0 0 0 0 Q 323 64, • 


4731 ■, 


1332 

4730 


4672 

4673 
46 73 



lOCATlON 

OPERATION 

variable 

COMMENTS 



1 


11 

IB 1 

30 









MACRO 

TABLE*INAMttUlV 





IFC 

EQt»*EQlV* 





TNAM 

EOU 

^-ORIGINS 





O.TNAM 

CON 

BUCKET 






ELSE 






TNAM 

EOU 

tQlV 





O.TNAM 

EOU 

O.EQIV 






rmt 






L.TNAM 

EQU 

TNAM*SIZES 






RMT 

• 







• 

• 

ENDM 

• 






..INIEH .. 

• 

• 

.TABLE 







iLliiii 



';TABLt 

/.:Wr 

• 

'lNTE« ' 

. EOU, 

^-ORIGINS 


■STABLE : 

' : l: 


0.inter" 

•".'CON 

ibUCKET 


■TABLE// 

^ .1 



'.RMT 

V'V 


TABLE 

•1 


L.INTER 

EQU 

. INTER*SIZE‘ 


TABLE , 

• i 



...RMT-'-.,. 



.TABLE 

. •! 



ENDM ■ 


... ' 

TABLE 

'•r 


LASTwB 

TABLE 







IFC .' 



TABLE , 

. • 1 


LASTAd 

EOU 

.^-ORIGINS 


, TABLE. 

• i 


O.LASTAB 

CON. 

.. BUCKET 


TAdLE: 

. • 1 



■ ELSE.': 

•'h' '' 


TABLE, 



, , ' . ' ! 1 

,rmt. V- 






.L-.LA.sfAH 

EQU 

; . : LASTAB+SIZES; ; 

'"/TABLE''; 

. i 



rmt'':.;- 



"TABLE 

.1 



ENDM '• 



TABLE 

• i 


NkTASv.,,... 

. TABLE 

LASTAb 






■ ELSE'-. 

' 2 * 


TABLE 

• 1 


NRTAa 

, EOU 

LASTAB 


TABLE 

Vi 


0. NR TAB, 

EQU' 

0.LASTAB 


.', table 

.1 






. ; TABLE 

•T 



rmt . . 

.\V,, ,' 


TAbLE 

• i 


L.NRTAb 

■ EQU': ' 

r NRT'AB + SI2E^ 


■./TABLE' 

• 1 



RMT 

' 


'•'TABLE 

• 1 



'endm"';' 

• 



,{ TABLE, 

.1 



m 

• 

...riERE , 






L. INTER,. 

... Eou;. ;, 

'.iNtER.+ SrzES 

'*RMT* 

• 1 


L.LASTAH 

- ' EQU., 

L'ASTAB^SI ZES'V'i 

/. ,*RMT* 

• 1 


1 i.NRf AB ' 

'EQu:,; v 

... nrtab+sizes 

1 

.»RMT* 

Vl 


60492600 A 






In the following example, assembly of the RMT sequence is caused by the END statement. 


100005012 


LOCATION 


OPERATION 


11 


FLD 

RMT 

DECMIC 

PR5 

LIT 


.list 

fld ,, 

DECMIC 

PR5 • 

L'IT 

PR5 ■ 

LIT 


VARIABLE COMMENTS 

_ ^ 

I — 

I 

dUF ►riUFL-^WSA+ £NUS 

decimal PEOUIhED.^^ 

I 

I 

.....C.......1....... 

bUF^UFL*-W5A + END'5 
C<J-;tFLDA DECIMAL REOUIPEO.^^ 
C^^25759 decimal REDUIkED.^ 


^HMT 


1 

I 

1 


5.3 CODE DUPLICATION 

This section describes two pseudo instructions (DUP and ECHO) that cause a sequence of code to be 
assembled repeatedly. For a DUP sequence, each assembly is identical with the first, and the 
number of repetitions is specified or is indefinite. For an ECHO sequence, each assembly resembles 
a macro reference. Actual parameters supplied in a list are substituted for formal jDarameters on 
each repetition of the code sequence. The number of repetitions is determined by the number of 
actual parameters provided on the ECHO instruction. 


Every inner DUP or ECHO sequence must lie totally within the range of the next outer DUP or ECHO, 
or a fatal E error is flagged. 


5.3.1 DUP-SIMPLE DUPLICATION 

The DUP pseudo instruction specifies repeated assembly of the statements immediately following. 

The range of the DUP is specified either by a source statement count on the DUP instruction or by an 
ENDD. 


Format: 


LOCATION 

OPERATION 

VARiABlt SU9FIEIDS 

dupname 

DUP 

rep,(net 


dupnaine Optional name of the DTP sequLMice; 1-8 characters. When slij)ii 1 led, it can be 

used ill an ENDD, When no name is supplied, the range of [he Dli^ is delerminet 
by a statement eounl or by any unnamed ENDD. 

rep Absolute evaliiatable expression specifying the integer number of* times state¬ 

ments in the DUP range are to be assembled. If rep is null or zero, the instrue- 
tions in the range are not assembled; that is, cuLle is skippeiL Wlicn base is i\I, 
COMPASS assumes that rep is deebnni. 
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NOTE 


A very large (unobtainable) repeat count in conjunction with a 
STOPDUP instruction can be used for indefinite duplication 
of code. 

Xnct An evaluatable expression speciftring an integer count of the number of 

statements to be assembled repeatedly. When base mode is M, COMPASS 
assumes that Met is decimal. The count is decremented for statements only; 
comment lines (identified by * in column one) are not counted. On each 
iteration, the assembler copies the source statements and then assembles 
them. Thus, any recursive statements within the sequence are counted 
before they are expanded. 

The dupname and Met parameters are related. 

1. If a count is supplied, it talces precedence over any ENDD. The only effect of an ENDD is to 
be included in the count. Under count control, a name is irrelevant, 

2. If neither a count nor a name is supplied, the DUP range is terminated only by an unnamed 
ENDD. 

3. If a name but no count is supplied, the DUP range is terminated by an ENDD with a matching 
name or by an unnamed ENDD. An ENDD with a name that does not match does not effect the 
range. 


5.3.2 ECHO - ECHOED DUPLICATION 

The ECHO instruction specifies repeated assembly of the instructions immediately following. On each 
iteration, the assembler copies the source statements substituting an actual parameter in the list for 
each formal parameter until the shortest list is exhausted, and then assembles the statements, ECHO 
offers many of the features of macros but does not require separate definition and reference. The 
range of the ECHO instruction is specified either by a source statement count specified on the ECHO 
instruction, or by an ENDD. The statement count, when used, is decremented for instructions only; 
comment lines, identified by * in column one, are not part of the definition and are not counted. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEL05 

dupname 

ECHO 

inct,p^=(listj),P2={list2), • • • .P^ ^ 


dupname Optional name of the ECHO sequence; 1-8 characters. When supplied, 

it can be used in an ENDD- When no name is supplied, the range of the 
ECHO is determined by a statement count or by any unnamed ENDD. 
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j^net Optional absolute evaluatable expression specifying an integer count of the number 

of source statements to be assembled repeatedly. If base mode is M, the 
count is assumed to be deeimaU If fact is zero or omitted, the comma must 
be present and the ECHO rai^e is defined by an ENDD. 


Any recursive statements, such as macro references, are counted before 
they are expanded. 

If the count exceeds the range of an outer DUP or ECHO sequence, a fatal 
E error is flagged. 


The dupname and fnet parameters are related. 

1* If a count is supplied, it takes precedence over any ENDD. The only effect of an ENDD in a 
count-controlled sequence is for it to be included in the count. Under count control a name 
is irrelevant. 

2. If neither a count nor a name is supplied, the ECHO range is terminated only by an unnamed 
ENDD. 

3, If a name but no count is supplied, the ECHO range Is terminated by an ENDD with a matching 
name or by an unnamed ENDD. An ENDD with a name that does not match does not terminate 
the sequence. 


p. Names of not more than 63 formal substitutable parameters. Each name is 1-8 

characters, the first of which must be alphabetic. A name cannot be END, 
LOCAL, ENDD, IRP, or ENDM. A second or later occurrence of a parameter 
name Is ignored. A name that begins with a number is ignored. The substi¬ 
tutable parameter name can occur in any field within a definition. 


The separator between p* and (list^) is conventionally an = but can be any of the 
following: 

+ -*/()$== 1 or . 

COMPASS recognizes a substitutable parameter name within a definition when it 
is between any two of the following: 

; +“*/()¥ = blanlc , . or r-*- 


Before the ECHO definition is stored, COMPASS replaces each use of a 
substitutable name. Otherwise, it saves the definition unedited, i.e., with 
micro and concatenation marks. Use of the semicolon is restricted in the 
definition because the assembler, when it expands the definition, interprets it 
as a substitutable parameter flag (77o). 

o 
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The character flags the occurrence of a name not bounded by any other 
special character and, thus, not otherwise recognized. When it expands the 
definition, COMPASS substitutes an actual parameter value from the list for 
the substitutable parameter and removes the so that the adjacent items are 
concatenated. 

Because the assembler replaces the first substitutable parameter with 7701, 
the second with 7702, etc. the programmer can use the display characters 
;A, jB, etc. directly in place of his substitutable parameter names in the 
definition and achieve the same results as if the assembler had replaced the 

name with the flag. (Example 8, section 5. 4. 3 illustrates a similar application 
of this technique.) 


Actual parameter list in the form a^, a 2 ,..., a^ where is substituted for 
on the first assembly of the ECHO sequence, ag is substituted on the second 
assembly, etc. until the shortest list is exhausted. Two consecutive commas 
are interpreted as a null parameter. An explicit zero, if desired, must be 
entered. An actual parameter can contain a set of embedded parameters 
enclosed by parentheses. However, the embedded parentheses must be 
properly paired. The assembler removes the outer pair of parentheses before 
substituting the embedded set in a line. A parenthetical item can contain blanlcs 
or commas. 


If there are no parameters or any of the lists are null, COMPASS assembles the 
ECHO sequence zero times, effectively skipping it. 


5.3.3 STOPDUP - STOP DUPLICATION 

The STOPDUP instruction allows premature termination of a DUP duplication before the repeat count 
is reached or of an ECHO duplication before the shortest list is exhausted. Assembly is completed to the 
end of the range for the current iteration and then continues with the next source statement. Only the 
Innermost dupUcatlon Is affected. 

( A STOPDUP outside of a DUP or ECHO range has no effect on assembly. If a DUP or ECHO is nested, 

STOPDUP terminates only the innermost DUP or ECHO. 

Format: 


lOCATION 

OPERATION 

VARIABLE SUBFIEIDS 


STOPDUP 



An entry in the location or variable Held is ignored. 



60492600 C 


5-9 








5.3.4 ENDD - END DUPLICATION SEQUENCE 


The ENDD pseudo instruction terminates a DUP or ECHO sequence when the statement count is 
unspecified on the DUP or ECHO. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELOS 

dupname 

ENDD 



dupname Name of a DUP or ECHO sequence, or blanlc. A named DUP or ECHO 

sequence can be terminated by an ENDD specifying the sequence by name, 
or by any unnamed ENDD. An unnamed DUP or ECHO sequence that is not 
controlled by statement count is terminated only by an unnamed ENDD. 

An ENDD does not terminate a sequence controlled by a statement count. 
The ENDD is included in the count but has no other effect. 

An ENDD outside the range of a DUP or ECHO has no effect on assembly. 

ENDD Is part of the definition it terminates; consequently, it is not edited at ECHO definition time. 
The following definition is in error: 

T r^l ECHO 
Code 

T r- lENDD 

In this code, the location field of the edited ECHO statement is Tl, but the location field of the un¬ 
edited ENDD statement remains at Tr^l. 


Examples: 

In the following examples, the statements that result from expansion are shown shaded. They are 
listed only when the E list option is selected. Source statements are shown in bold characters. 

1. This example illustrates use of a simple DUP instruction. 


Location Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


11 

IS 

30 

00000=. 



DllP 

. 1 





IIATA 

1 


5153 OOOOOOOODOCOOOOOOCO1 



DATA 

1 

1 

515^ 00000000000000000001 



data 

1 

1 

5155 OOOOOOOOOnonoOOOOOOi 



Data 

1 

1 

sisf. onooooooonooooooooo 1 



DATA 

1 

1 

5157 oooonoooooonoooooool 



data 

1 

^L)UP*> 1 
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This example illustrates a nested DUP instruction with one of the DUP duplications terminated 
by a STOPDUP. 


LOCATION 

OPERATION 

T 

11 


KlO 

r.o 

alphabet 

^^;0 






MACPO 

MICRO 

IFC 

STOPDUP 

SFT 

ENDM 

MICRO 

SET 

DUP 

GO 

ENOO 

go: 

MICRO.:: 

.MicRd'r' 

-IFG:V\:'r 
-IE:C'-::'%: ' 

STOPDUP, 

set;-,'//'-; 

ENDM-''-;'-' 

ENiDp:/-;:, 

070':': 

MTt'RO'-V •, 

micro' 

■'TEC., 

STCi-PPLIP^ 

Et^'bb; "V" 


NOt 1 f/^^ALPHAHET;^/ 

E0i/^TAG7i/E/* 1 ASSEMBLE STOpDUP WHEN TAG=E 


1 f f/AHCDEFCiHlJK/ 
I 

-I 


NO IS 6 IN LAST ITERATION 


UNOBTAINABLE ITERATION COUNT 


AL>HABEttt/X^-y-^\;:';vj 7 ,1;:: r'V';'': 

mn I < /ABCDEFGHl jky\V.= •: ^.VL'lX >'•^'S- 

EO't / t.H(J ^/E/ ^I ■ = 4sSEMBL;E. STd'PbUPy -WHEN''T AGtE^ 
E pV/ A / E'/',t ,1 ASS EM 41E;' ,S'Tp P DUP yW'H E 


mvi v/JiALpH ABET?t/V V/ 

Nd,'i V>-A'BCDEF.GJ1 j'K/'---' v'-'v? •' ^''V.y'y'W 

EOi:/VT:AG//E/f 1 ' ASSEMAiU'Ey STOPDUP : WHEN'-TAG^EA: 
E Oy /B / E/ n I : V I'': '’: ■ A's's E M H'L E.V STOPDUP ' w H E N j- TAG? E;l 


N0 + 1 


;Nd-4ts IN 5E AST'' I T E R At'ldN'?:’? 


vttDUP* 
GO y 
GO ; 
GO - 

rGd':V 

-Go;y 

"go 

'•Go:',.:r-: 

y«DUP^: 

■'Gdy^ 

go 

GO:. 

go--.- 

'GO::-- - 
GO":'-//; 

iG,0 

>DUp^/ 


TAG/,// 

tag:/;;::!;; 


no:;://':-/: 


GO. ' ■; / ' - 

MICRO ;■ 

M.repd 

-I'FC: 

1 EG. 
stnROiJP. 

SF'TV:/;// ' 

E'lslpK'V':/. 

E4prt/:4;: 


Nd'f/i--i7A'BCDEFGr^i .o'' kY'/ ; Y 

E.OYy';^.T AG?^/E/* X. . ‘ .YaSSEMHLE' STOPDUP WHE:N 'TAfet-:;' 

EPfVE/E/.?.i;; vv./'Y, :Assemble;, stoppup i when. 

Haid:/'//Y-tvY, y;/YYY/ moYt s^i&Y'iN/i a^Y iTER ati 


. '■tt'DUc^«* 

:go 

GO : : 
GO .. 
GO ' 
GO . 
GO \ 

•' GO 

;.«^DUP<*^: 
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This example illustrates nested ECHO instructions. A statement count terminates the second 
level ECHO The ENDD terminates the first level. Notice how COMPASS assembles each 
copy before It begins the next iteration. 


Location 

Code Generated 


lOCATtON 

OPERATION 

VARIABLE 

COMMENTS 




1 


1i 

le 

30 





PPU 

• 








FTM 

• 

• 

PPOP 

5 9 54 15h 








LIST 

M , 0, F 








ECHO 

,CM-(x,y,zi 








ECHO 

2,P1=(A,H»C) 








LDN 

CM 








STK 

PI 




...,..^.... 

..............,. 

... 

....... 

ENnO,....: 

.....-L-.v.. 



;. . 


•; •' ■; V.; 



ECHO ' 

'2»'Pll.= '(AvBt.Ci 




:' ;*.■ -/.^ 

V ■' >■ ' \ ' 



LDN 


TTT-' 


y^ 1:77 


'i 7 '' •'.' v"'-'. 



Sty.;--' 

p'l';• 


''7‘;>echo 

i 


:^7'4S'*V■' * 

1 

'. j ]' • •: j ,. , 

LdW':-;.!' 

X ■'-7;;;;;;./:; 


■%■•;• .*E,CHO' 



00 36 

sii 


STM . 






:-;74'5'p.\ : 

’ii; 


L 



'7.’;'7EXH0 ';'v7V'} y 

;'.--2.7-::i: 


: '5:4.is- 00.17 


‘'V-.v. '' ' ' 

STM-' - 

[3V-"-" -VC- 


••■■-yECrio 

''■'2'';'7 


.■.■-i-^bo, v-: 


'v! - ' ; •. r, 

L ON -' -■ 

y-'-:' :• r-.''.v' 


•• .^>ECHo~ ..4 

'■? '7: 

'l^'for;:-"-.v 

p4 0 , 



STM 

r ; ; : 

1' • 

^ECHU 

2 

", '/'VV- 




ENOn ; 

“ ' ■ '.'1' : •• r!' ■ .'■ ' , i 


"T'^ECHO 

' 1-7- 

'• '' . ■ : ; ■■ \ 

’ '^ 



echo 

■2Vpi-'U'Vb.iC). 

i- 

.-'••.■if EC HO 

1. ' 


'V" ' 


' K "• ‘ 

LONv':' 

Y 


/'■-'^ECHO 

■■'i 

. . 

.■ ': . . 'i ;* 


V • V 

STM-'':"; 

Hi'.'/' ' ■ 

1. 'i 

V-- .'■-^^ECHO.jv; r;.';: 7 . 

7‘ 1'''7 




7''■■. ; 

LDN.^: , 

Yi-'-.' v'J.-V 

1. 

:-'7echo'' v.7y7- •• 

.':-.2 7;.: 

14 64.‘.; • 

;V':54i5r6'b3V:?:' = 


" i t'C; 

STM': 

• 

1 ■ 

'..'V'^EChO 

2';'7.- 

1 466 ' 

•■v;i'46n\: 



ldn: .' 

Y:' -'i'' 


7.'''"-^ECHO 

'72 ,.--'7 


'S^is ;0 037;; : ;^V.V 


V' 

SjfJ' ■' 

b. V? y-C'iPV'v.^- v 

I 

' '\y '-^ECHO yy 

ZM 

1471 



7.: 

llDN ' 


1 ■■ 

■';\i.>.ECHO :y:; y.7 

'' 2 

147?; ;;7 . 

V:54l5\d64p>; 



STM 

c 

1 ■ 
i ■ 

7 -7' *ECHO 

'■''2 




V ' 

E^lub 


l^. 

v7’; :frEChO -y^y 

- ■ 1 

■' 

. i ' ■ . 



ECHO 

2',Pi:=;(/i,BT'c)'i; : 

«ECHO 

\ 7. 

• ' ■ ^ ''' 

;; • • ', - • ' ' 



LDN . 


r' • 

''.'■7;fECH'o.J.v:y!'; 

,! i-7'; 

' .' ; '■ ■- 

' ' *• ... 


'■vV ' ' \ • ' 

STM 


1 



' 3 474;-';''-*; 

■V;i4>70- 



EPN.; ' 

Z Ir.v-'' 


y’^'''^ECHo%yy -■ ■; 


^ 1475.-:''//'.- 

\',5MA"'0 03’'6' 


-:\e 

STM’' 

.A'-;-' l'V.;' 


:;7EC‘H67fvy7‘V-. 

. 2. .7. 

1477 

v' 


. 

LHN. 

-M/v;.', 

L^-v 

7-- 

y'2 -;7 

1500 



; '■ •: * • 


B 

[• •.:. 

•• 



"147,0- 


'-n'■': 

LPN'. 7 :.: 


W' 


■”:.2 

i;.1503'7--;V 

f :;f54J5;\ 0bV0'::--V 


’• ■ 

5TM.^'= 



:7y^^^EcHd7y^S'?7:■■■• 

'■ '2''7^: 

I'..;.'."; 



:.. :.C ' 

ENDO 

*. '•./. 




1505 

5415 15?4 



STM 

TAG 
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5.4 MACROS AND OPDEFS 


A macro or ppdef definition is a sequence of source statements that are saved and then assembled 
whenever needed through a macro or opdef call. A macro call consists of the occurrence of the 
macro name in the operation field of a statement. It usually includes parameters to be substituted 
for formal parameters in the macro code sequence so that code generated can vary with each assembly 
of the definition. 

An opdef call differs from a macro call in that the assembler interprets the call by examining the 
format or syntax of the instruction rather than the contents of the operation field alone. The instinjction 
comprising the opdef call usually includes parameters to be substituted for parameters in the code 
sequence. There are some differences in the way parameters are substituted, however, as is further 
described under Opdef Call. 

Use of a macro or an opdef requires two steps, definition of the macro or opdef sequence, and calling 
of the definition. 

A definition consists of three parts: heading, body, and terminator. 

Heading A macro definition is headed by a MACRO or MAC ROE pseudo instruction 

stating the name of the macro and identifying substitutable parameters in 
the body of the macro. 

An opdef definition is headed by an OPDEF pseudo instruction stating the syntax 
of the calling instruction and identifying substitutable parameters in the body of 
the macro. 

The heading optionally includes one or more LOCAL instructions identifying 
symbols local to the definition. 

Body The body begins with the first statement in a definition that is not a LOCAL 

statement or a comment line. A comment line can be either identified by * 
in column one or can have columns 1-29 blank. (Following the first statement 
of the macro body, only comments identified by * in column 1 are ignored.) 

Use of the semicolon is restricted because when a definition is expanded a 
semicolon is interpreted as a substitutable parameter mark or a local symbol 
flag. 

The body consists of a series of symbolic instructions. All instructions other 
than END, including other macro and opdef definitions and calls are legal within 
a definition. However, a definition within a definition is not defined until the 
outer definition is called. Therefore, an inner definition cannot be called before 
the outer definition is called. 

A name of a substitutable parameter or local symbol listed in the heading can 
occur in any field within the body. A reference to a substitutable parameter or 
local symbol is recognized when it is between two of the following characters in 
an expression or field: 

: +-'*/()$- blanlc , , 7 ^ or 

The character|—^flags the occurrence of a name not bounded by any other special 
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character, and, thus, not otherwise recognized. On a call, the assembler 
substitutes an actual parameter value for the substitutable parameter and 
removes the i—♦ so that the adjacent items are concatenated. 

NOTE 

The programmer can legally use the characters . ( ) : 

$ and =in symbols, but when he does, he must be careful 
that these characters are not interpreted as delimiters in 
macro definitions (example 4 under macro calls). A symbol 
should not begin with a colon; if it does, the colon is 
ignored and no error message is issued. 

The macro body optionally contains IRP pseudo instructions that allow iterative 
assembly of a sequence within the body such that each iteration uses a different 
parameter value. 


Terminator An ENDM pseudo instruction terminates a macro or opdef definition. 

Definition 

Processing A macro or opdef can be defined anywhere in a subprogram before it is called. 

When COMPASS encounters a definition, it places the name of the macro or the 
syntax of the opdef along with the number of substitutable parameters and local 
symbols in the assembler operation code table. Before the definition is saved, 
COMPASS replaces each occurrence of a parameter name or local symbol with 
a 77xx (where xx is a number assigned to the substitutable parameter or local 
symbol). 

On the call, each use of a substitutable parameter (each 77xx) is replaced by 
its actual parameter; each use of a local symbol is replaced by a unique symbol 
generated by the assembler. Usually, symbols replaced in this way have no 
meaning outside the definition. However, if the macro includes an RMT 
sequence which contains local S 3 anbols, the local symbols will have meaning 
where the remote code is assembled outside of the definition. 


5.4.1 ENDM-END MACRO DEFINITION 

An ENDM terminates a macro or opdef definition. 
Format: 


LOCATJON 

OPERATION 

VARIABLE SUePlElDS 

mname 

ENDM 



mname Name of a macro sequence, syntax of an OPDEF sequence, or blank. 
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An ENDM specifying a macro by name terminates the named macro definition and any unterminated 
macro or opdef definitions within it. An ENDM that does not specify a macro by name terminates all 
iinterminated definitions. An ENDM outside the range of any macro sequence has no effect other than 
to be Included in statement counts. 

ENDM is part of the definition it terminates; consequently, It is not edited at MACRO definition time. 
The following definition is in error; 

Tn^l MACRO 

Code 

Tr^l ENDM 

In this code, the location field of the edited MACRO statement is Tl, but the location field of the 
unedited ENDM statement remains at Tp^l. 

Example: 



5.4.2 MACRO - MACRO HEADING 

A MACRO pseudo instruction notifies the assembler to place the instructions forming the body of the 
macro in a table of macro definitions for assembly upon call and place the macro name in the operation 
code table. 

The MACRO pseudo instruction has two forms: 

Format one; 


LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 

mname 

MACRO 

parameters 
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Format two: 


LOCATIpN 

OPERATION 

VARIABLE SUBFIELDS 


MACRO 

mname, parameters 


The blank location field identifies the second format. 

mname A legal name other than END, ENDD, IRP, LOCAL, or ENDM. 1-8 characters. 

A name that is identical to a PPU symbolic machine instruction, pseudo 
instruction, or macro already in the operation code table redefines the 
instruction. The most recent definition applies for the macro call. A 
redefinition causes an informative flag to be issued but the new definition 
holds. 

parameters Names of substitutable parameters. The order in which names are listed 

determines the order in which parameters must occur in the macro call. 

Each name is 1^8 characters, the first of which must be alphabetic. A name 
cannot be END, IRP, LOCAL, ENDD, ENDM, or the same as a local symbol. 

A name that begins with a number, or a second or later occurrence of a para¬ 
meter name in the list is ignored. 

Any of the following special characters separate parameters in the list; 

+ -*/()$=, or . 

These characters have no meaning other than as separators. A blanlv 
terminates the list of parameters. Also, any of these characters can be used 
to separate the mname from parameters in format two. 

The total number of unique parameter names and local symbols must not 
exceed 63 for any one macro definition. 

Format one does not require parameters. 

Format two requires at least one substitutable parameter. This parameter is 
termed the location argument because the location field entry in the macro call 
is its substituted value. Omission of the location argument from a MACRO 
instruction in format two causes the assembler to issue a fatal error and 
ignore the definition. 

The assembler ignores a blanl^ parameter produced by two adjacent 
separators or by a separator at the end of the list. 

For an example of definition and calls, refer to Macro Calls. 
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Examples of macro instructions: 


1 . Legal MACRO instructions: 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

I 


n 

18 ho 


ABC . 

MESSAGE 

MACRO 

MACRO 

MACRO 

-1-^- 

PlfP2tP3 1 

DEF^LOC»ONE»THO»TEN 

A ^ 


2. MACRO instructions having identical parameter lists. 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


n 

ie 

ho 





. .... . 1 - 


SUM 

MACRO 

X-Y+7+X 

ISECOND X PARAMETER 

IS IGNORED 


SUM 

MACRO 

X(Y+2) 

1 

1 



SUM 

MACRO 

X«Y+Z 

1 



SUM* 

MACRO 

X,Yf CZ^X) 

•null parameter and 

SECOND 


RAO 

MACRO 

X 

[x are ignored 



RAO 

MACRO 

X=X41 

{second X AND NUMERIC 


IPARAHETER ARE IGNORED 


3. Illegal use of format two: 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


II 

IB 

ho 



MACRO 

MACRO 

MACRO 

ABC 

ABC,,FP 
ABC,16,FP 

j NO SUBSTITUTABLE PARAMETER 

1 NULL PARAMETER FIELD 
, NUMERIC PARAMETER FIELD 
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5.4.3 AAACRO CALLS 


A macro headed by a MACRO pseudo Instruction can be called by an instruction in the following format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

sym 

mname 

PitP2»“ •'>Pn 


sym Optional; depends on definition (see discussion following) 

p. Parameter list composed of alphanumeric strings. Parameters are separated 

by commas and terminated by a blanlc. Two consecutive commas constitute 
a null parameter. An explicit zero, if desired, must be entered. 

Each parameter must be in its correct relative position depending on the sequence 
in which its formal substitutable name is given in the MACRO pseudo instruction. 

When the definition MACRO is in format one, the first parameter in the call is substituted wherever the 
first substitutable parameter occurs in the definition, the second parameter in the call is substituted 
wherever the second substitutable parameter occurs in the definition, etc. WTien the definition MACRO 
is in format two, the location field entry in the call is substituted wherever the first substitutable 
parameter occurs in the definition, the first parameter in the variable field of the call is substituted 
wherever the second substitutable parameter occurs in the definition, etc. 

If null parameters are interspersed with legal parameters, the correct positions must be established 
with commas. When the list terminates before the last possible parameter, all remaining parameters 
are considered null. 

When the first character of a parameter is a left parenthesis, the assembler considers all the 
characters between it and the matching right parenthesis as an embedded parameter or as an iterative 
parameter. It is an iterative parameter when the substitutable parameter has been named in an IRP 
pseudo instruction (section 5.4. 9). Otherwise, it is an embedded parameter. 

The assembler removes the outer pair of parentheses before substituting the enclosed character string 
in a line. Embedded parenthetical items must be properly paired. A parenthetical item can contain 
blanks and commas. 



After substitution, spacing between fields is the same as it was before substitution. One effect is that 
a null actual parameter replacing a formal parameter in a variable field effectively moves the comments 
field to the left. Then, when the line is assembled, the comments could be erroneously interpreted as 
a variable subfield. 
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Processing of a location symbol and forcing upper of the first macro instruction depend on the MACRO 
form used for the definition. 


If the macro is defined using format one, that is, the macro name is in the location field, a location 
symbol on the macro call line forces the first word of generated code upper, 'fhe location field symlxd 
is assigned the current value of the location counter. A location I'icld (if any) on the line in the 
definition that generates the code is assigned the same address. If the location field of the macro call 
does not contain a symbol, the location and position counters are not affected by the call. 

When the macro is defined using fonnat two, that is, the macro mune is in the variable field and the 
first parameter is a location argument, the location symbol of the call is substituted for the first 
parameter or location argument. The fact that this argument came from the location field rather than 
the variable field has no special significance in the macro expansion. In the macro call, the location 
field argument cannot be more than 8 characters. Parentheses are not given the special meaning used 
in the variable field of a macro calUine. 

Example: 

1. An illustration of concatenation 


Location Code 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 



Generated 

1 


II 

16 

|30 



KACt<; 

MACRO 

Sr*Pl 

m 








• 

LNDM 

• 





c bo b ; 



• 

* 

mack 

tUDM j 

Ac?, A 

■'A'^+XRS’AT'iBu'^;, 
AiiXl R A XXWSi-;' 

mMAGK 

if'] ' 

MACK 

..'l.... 
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2. An illustration of nested delinitions and calls 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


It 

IB ho 






NAME 1 

• 

• 

• 

NAHE2 

NAME2 

nahei 

MACRO 

• 

* 

■ 

MACRO 

• 

• 

■ 

enum 

• 

• 

• 

NAHL2 

« 

9 

ENDM 

• 

« 

• 

NAME! 

■ 

• 

NAHE2 

-1 

1 

f 

1 

1 

1 

1 

1 

1 

lAT THIS 1 IHEt This LIHL 
'!:) part (JK a JtFlHllIOK 
{kAIHEP IHAh iElNG A CALL. 

1 

t 

1 

I 

f 

1 

1 

JnAMEI is CAlLlU ANL EXPAimUEU. 

1 

1 

1 

1 

1 

’call to NAHE2 IS VALlO 

1 


3, The following example illustrates two calls to a definition headed by a MACRO in format two 
using the location argument. The macro is named TABLE; its substitutable arguments are 
TABNAM, VALUEl, and VALUE2, where TABNAM is the location argument. 




LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


Location Code Generated 

I 


11 

IB 

|30 






MACRO 

TABLE.TABNAM.VALUEl* 

VALUE2 



T 

ABNAM 

VFD 

bO/VALUEl 

.6P/VALUE2 






ENDM 

• 


[ 

1 


4741 

i 7 2 0 4 0 0 00 b 0 6 0 0 0 6 6 0 0 b ' 

s 


• 

table 

1.0.2.0, 

1 

1 CALL ONE 

' ' 

4742 

17214000000000000000 

5 


VFD 

60/i.o»60/a.o - 

STABLE .1 





ENDM 



;''r table .1 

4743 






'*'1' ' ' '' ' . 


4743 

i7?04000000000000000 ■ 



TABLE 

r.o \ 

:jcALL TWO 

■■••TABLE •!•' 

4744 

OOOOOOOOOOOOOuOQOOOO ; 


VFD 

,,,60/1. 

0.60/ 




BBiliSllliiilfiiiSBiiB 



'ENDM , 



'.;\W;ABLE’;-';-'.t' 
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4. An illustration of embedded parameters 


Definition: 



LOCATION 

OPfRATtON 

VARIABLE 

COMMENTS 

I 


11 

ta 

|30 




- 


X zip 

MftCRO 

LHM 

LJM 

FMTM 

(i,p i 

^ 1 

1 


Call: 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


11 

IB j30 



XflM 

(-sIlH, nn) , (SAM jTNfT') 


Expansion: 


Location Code Generated 


LOCATION 

OPERATION 

VARIABLE COMMENTS 

,7303’';' • '^01 : 

,7305' . , , 0117 7243 

1 


n 

IB ho 



LOM 'c 

LJM 

ENDM 

SUM.1 Oft , 1 

5AM.IND3 1 

1 

. 1 


5. The following example illustrates use of R^-- in macros: 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


11 

IB 

ho 






ONSH 

MACRO 

M 

1---- 

\ 



R = 

XI,N 

1 

1 



5X^ 

IIP 

1 



RJ 


1 



ENOM 


1 


OFFSW 

MACRO 

N 

1 



R= 

XI ,N 

1 



SX2 

12B 

) 



RJ 

=xrPM= 

1 



fndm 


1 
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6. The following example illustrates a character in a symbol erroneously being interpreted as a 
delimiter for a parameter. 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


11 

IB 

ho 






ABC 

Z 

MACRO 

SET 

SA7 

• 

Z,VAL,P5 

VAL 

2.ALPHA 

• 

1 

1 

IlLLEGAL SYMBOL. TOO LONG 

1 


IOTA 

1 

• 

ENDM 
ABC-,- ' 

, SET. 
SA7, 

endm 

• 

10fA»l,3: 

.. 1 . 

IOTA.ALPHA 

1 

1 

1 

1 ILLEGAL SYMBOL. TOO LONG 

1 


ABC 

ABC 

ABC 


• 1 
•1 
• 1 


7. The following example illustrates changing of control blocks and sjmibol qualifiers through 
substitutable parameters in a macro. (The same call could be used by using micros to 
change actual parameters.) 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


11 

18 ho 






TAB 

MACRO 

BLOCKfKWAL 





USE 

BLOCK 1 





QUAL 

KUiAL 1 




TAGl 

ass 

lOB 1 




TAGS 

VFD 

60/-1 ) 





USE 






DUAL 

« 1 





ENDM 

• 

1 

1 





• 

TAB 

1 

ONE,ONE ! 





USE . . 

ONE 

TAB 




dual ■ 

ONE- 

' tab:-.:-; 

•'..iv 


•TAGli i 

BSS 

lOB' 

TABX :•/. 



TAGE'.'W;' 


6o/-r ; r ■ . 

^ tab: 




USE 


- •-•'tab 

• • '•i-, 



OUAL 

"■'.V - I ; ' 

TAB , 

• i 



ENDM , 


,■ ^'Tab , 

.1 



TAB 

fwo.TWO 1 





USE 

TWO 1 

' TAB' ' 

.1 



qual 

TWO 1 

TAB 

.1 


TAGl ... 

BSS 

lOB- 1 

TAB 

.. .1 


TAG2' 

VFb ■ 

60/-1 1. 

TAB 

.1 



USE 

V.. ,1 ' 

TAB'. ; 

• 1 



QUAL 


■ TAB:; 

.'.'..I ■■ 



ENDM ,. 

■'•v lV-"/ 'i - 'V;/.:''/-.' 
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8. The followin''- exiniiple illiiHtnilef :i teehnkiue Uial an experienecd pro-^i-aminer may winli Lo 
use to save time in processin*;- of definitions. Ilememher that Ihe assemhler replaees the 
first substitutable parameter with 7701, the seeoinl w ith 7702, ele. Note that 7701 is ;.\ in 
display characters, 7702 is ;B, etc. 'I'his means that the piaiuraminer can use the displav 
characters directly in place of his substitutable parameter names in the bmly of the definition 
and achieve the same results as if the assembler had made the'substitution when it saved the 
definition. At the time the definition is assembled, the assembler reiilaees each 77xx with the 
actual parameter whether the code was inserted by the assembler when it saved the definition 
or by the programmer when he coded the definition. 




lOCAtlON 

OPERATION 

VARIABLE 

COMMENTS 


j 


11 

IB 

ho 




MACRO 

ASC I I t INTEC'NAL*i:xTF.P^AL .bCU 




co^ 

S 0 ; c; R ! A 





ENOM 

• 



o.*o 



« 

• 

RAsr 

n 

U 





CHAP 

'+3 vlOi 10.30 

n 

:'-7771;:.';'0000000 0 0 0 003u i 0 i 043;;. 


MiBsyESiiiff 

cn/;;-'y;-. 

'■ioro-fOA3, ■ . ' 

;';yy-i;cHAR-. . i- .'.i' • 




Fhihn • 

' 

Chap:-'''.,;- i:-,-,: 

777?. 


. ... 

chap 

M-i/ll , 1 1 *31 . 

9 

,7,7,7,? ; OOOOOOCOOpOQ.Tl.ri'l = 



r.ok- 

31,1111‘^4; • 

."'V''' char,'-. 1 

1, ,v, „■ •,i • 




. ' 

'L .1.' G hi A p f,. ;; , ■' \ '• } 

. . . ........ . 




b f ^ 0 1 ? 0.1 3, 

+ 

:7773;;i dap.o0o,onooop'i3 ?6 



COM; 

13?0f*0^D, 





EUbM;;/; 


3 CHAR.;/:'',;:';; ! 

.777,^t.. 



CHAD 

;^6i40f 40. lb 

- 

;7774;::;v:Pp;0:0;OOGOOn'C'^^^ ' ■ 


• 'A 


1^404046 

• CHAR'-'" l : 




fnum';.'.; 


'CHAP;.:,- : l'' 

..77.7?... ., . 



chad 

^ y b 4 f S 4.1 ? 


i,?.'?'??:; p,()ho'ooooooo,o'i2 5'4b;A'7", 




i Br} 





; 

; 

'■.-..Char 

,777S 



Ch.A.p. 

0 y 1 . M . 1 7 

/ 

;777A-, OO'OOOOOOO'lOOW'rlPlbO 



Cntivi :' \ 

ns.Tgi'R/'y.-- 

';-'XhAp. ^ J ^ 



ENOVy':’;' 

|\' ■' a’ - '1 i : ' 

r li/Z-yC’-.CMAR ; ; ^ 1 ■ 
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5.4.4 MACROE - EQUIVALENCED MACRO HEADER 

A MACROE pseudo instruction can be used instead of a MACRO instruction to notify the assembler to 
place the instructions forming the body of the macro in a table of macro definitions for assembly upon 
call, to place the macro name in the operation code table, and to save the list of parameter names so 
that actual parameters supplied in the macro call can be listed by name in any sequence in the macro 
call. 

The MACROE pseudo instruction has two forms: 

Format one: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIOS 

mname 

MACROE 

parameters 


Format two: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


MACROE 

mname, parameters 


The blank location field identifies the second format. 


mname A legal name other than END, ENDD, IRP, LOCAL, or ENDM. It can be 

1-8 characters. A name that is identical to a PPU symbolic machine instruction 
name, pseudo instruction, or macro instruction already in the operation code 
table redefines the instruction. The most recent definition is the one that applies 
for the macro call. A redefinition causes an informative flag to be issued but the 
new definition holds. 

parameters Names of substitutable parameters. Unlilce MACRO, the order in which names 

are listed does not determine the order in which parameters can occur in the 
macro call. Each name is 1-8 characters, the first of which must be alphabetic. 
A name cannot be END, ENDD, LOCAL, IRP, ENDM, or the same as a local 
symbol. A name that begins with a number, or a second or later occurrence of 
a parameter name in the list is ignored. Any of the following special characters 
separate parameters in the list: 

+ -*/()$ = , or . 

These characters have no meaning other than as separators. A blank terminates 
the list of parameters. Also, any of these can be used to separate the mname 
from parameters in format two. 

The total number of unique parameter names and local symbols must not exceed 
63 for any one macro definition. 

Format one does not require para meters- 


5-24 


60492600 A 






Format two requires at least one substitutable parameter. This parameter is 
termed the location argument because the location field entry in the macro call 
is its substituted value. Omission of the location argument from a MACRO 
instruction in format two causes the assembler to issue a fatal error flag and 
ignore the definition. 

The assembler ignores a blanlc parameter produced by two adjacent separators 
or by a separator at the end of the list. 

For an example of definition and calls, refer to Equivalenced Macro Call. 


5.4.5 EQUIVALENCED MACRO CALL 

A macro definition headed by a MACROE pseudo instruction can be called by an instruction of the 
following format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELOS 

sym 

mname 



mname Name of MACROE definition 

sym Optional symbol, A sjmbol in the location field causes the location counter 

to be forced upper. The symbol is then assigned the value of the location 
counter, A location field symbol on the first line in the definition that generates 
code is assigned the same address. If the location field of the macro call does 
not contain a siunbol, the manner of the force upper is a function of the first- 
code-gene rating line in the macro ex|Dansion, 

p.=a. An equivalenced parameter. Each p is the name of a substitutable parameter. 

The a. is an actual parameter to be substituted for P|. The parameters need not 
be listed in the same order as they are listed on the RIACROE instruction, 
Equivalenced parameters in the list are separated by commas and terminated 
by a blanlc, 

A null value is substituted for any parameter omitted from the list. 

When the first character of an actual parameter is a left parenthesis, the 
assembler considers all the characters between it and the matching parenthesis 
as an embedded parameter or as an iterative parameter. It is an iterative 
parameter when the substitutable parameter has been named in an IRP pseudo 
instruction (section 5.4.9, IRP). Otherwise, it is an embedded parameter. The 
assembler removes the outer pair of pa.rentheses before substituting* the enclosed 
character string in a line. Embedded parenthetical items must be properly 
paired. A parenthetical item can contain blanlcs and commas. 
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Aftex' substitution, spncing* between fields is the smiie as it was before substitution. One elTeet is that 
a null actual parameter replacing*' a fuianal pai^amcter in a variable field efrcctively moves the comments 
field to the left. Then, when the line is assembled, the comments could be erroneously interim re ted as 
a variable sub field. 

Processing of a location symbol and forcing upper of the first macro instruction depend on the MACllOK 
form used for the definition. 

If the maci"o is defined using format one, that is, the macro name is in the location field, a location 
symbol on the macro call line forces the first word of geiiei'atcd code upper. The location field symbol 
is assigned the ciiri'ent value of the location counter, A location field (if any) on tiie line in the 
definition that generates the code is assigned the same address. If the location field of the maci'o call 
does not contain a s^nnbol, the location and position counters are not affected by the call. 


When the macro is defined using format two, that is, the macro name is in the variable fieid and the first 
parameter is a location argument, the location symbol of the call is substituted for the first parameter or 
location argument. The fact that this argument came from the location field rather than the variable field 
has no special significance in the macro expansion. After substitution, spacing between fields is the same 
as it was before substitution. 


Example, format one: 


Location 

Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 




1 


1} 

IB 

30 











SAM 

MACROE 

A,B,C 







CON 

A 







CON 

B 







CON 

C 







SAM, . 

A=.1 ,C = 5,,0 = D 



500 7 

'^'0 0 n 000 0 0 0 0 d 00 0 0 n o n o i 



CON 

1'-^'I-v^v;V' 

- SAM - 

'■'T-;.' 

5010 ' ' 

' oaODOnOODOOOOODOUOQO, 




n : 



5011 . 

^ g P.D q o n □ b o o o n o g o o n p q p.; ;- 



C0N.'„.,„ 


SAM'.' 

'■i- ,: 





endm,;;:' 


SAMV 

■i-.v- 


Example, format two; 


Location Code Generated 


LOCATION 

OPERATION 

VARIABLE COMMENTS 

? ccocoooococ j:; 00jL 

1 


n 

le 

30 



•M a: VMt 

C’lr. 

C 11*. 

C.iN 
( 'ID’1 

S am 

sill 

A 

n 

c 

L 
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5.4,6 OPDEF -- DEFINE CPU OPERATION 


An OPDEF pseudo instruction notifies the assembler to place instructions in the body of the definition 
in a table of definitions for assembly upon call and place the instruction S 3 mtax in the operation code 
table. There is no way of removing the definition from the table. It can, however, be bypassed 
through redefinition, or disabled through PURGDEF. If the syntax duplicates a CPU instruction already 
in the table, the OPDEF definition takes precedence. 

Format; 


LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 

syntax 

OPDEF 

parameters 


syntax The syntax consists of a mnemonic operator and variable field descriptors. 

The mnemonic operator consists of two characters. The first can be any 
character except blank. The second character can be a register designator: 
A, B, or X In which case the operation field of the opdef call is recog¬ 
nized as cAn, cXn, or cBn (c is a unique character; n is 0-7); or the second 
character can be any other character, in which ease the operation field of 
the opdef call is recognized simply by a two-character mnemonic, such as 
EQ. 

The variable field descriptors define the order of appearance of all registers, 
expressions, and subfield separators that comprise the variable field of the 
opdef call. It consists of none, one, two, or three of the following 22 subfield 
descriptors. Q represents an expression. An r represents a register letter 
(A, B, or X). A comma separates two descriptors; a blanlc terminates the 


syntax. 


void 

Q 

r 

rQ 

-r 

-rQ 


rj H-rgQ 


-ri+r2Q 



'^1*^2 

Ti+rgQ 


/rgQ 


-ri/r2Q 


r^-r2Q 

-r -r 

1 2 



60492600 B 


5-27 








For example, would be written as -X*B to describe -X3*B1 whereas rQ 

would be written as BQ to describe B2+ALPHA. The first descriptor immedi-- 
ately follows the mnemonic operator. 

A substitutable parameter for each register designator (r) and expression 
parameters designator (Q) in the syntax in the order in which they occur in the syntax 

(and, consequently, in the calling instruction). Each name is 1-8 characters, 
the first of which must be alphabetic. A name cannot be END, ENDD, ENDM, 
IRP, LOCAL, or the same as a local symbol. A name that begins with a num¬ 
ber, or a second or later occurrence of a parameter name in the list is ignored. 
Parameters can be separated by any of the characters: 

-+/()$ = , or . 

These characters have no meaning other than as separators. A blank terminates 
the list of parameters. 

The total number of unique parameter names and local symbols must not exceed 
63 for any one OPDEF definition. 

The assembler ignores a blank parameter produced by two concurrent separators 
or by a separator at the end of the list, A second or later occurrence of a 
parameter name in the list is ignored. 


Examples: 

1. Listed below are some instructions that could be defined through OPDEF; 


Calling Instruction 

Opdef 

Syntax 

Operation 

Variable Subfields 

JPt 

Ktf- 

JPQ 

jpt 

' Bn+K 

JPBQ 

JP 

Bn+Bn+K 

JPB+BQ 

JP 

Bn,K 

JPB,Q 

JP 

Xn/Xn+K 

JPX/XQ 

NEt 

Bn, Bn, K 

NEB.B.Q 

LJ 

Bn-Bn, An-Xn, K 

LJB-B,A-X,Q 

BXnt 

-Xn*Xn 

BX-X*X 

SBnt 

Xn+Bn 

SBX+B 

LXnt 

Bn, Xh 

LXB,X 

jpt 

Bj+K 

JPBQ 

NEt 

Bj,Bk,K 

NEB,B,Q 

BXit 

-Xk+Xj 

BX-X+X 

SBit 

Xj+Bk 

SBX-fB 

SBit 

Bj+Xlc 

SBB-iX 


t Legal COMPASS CPU instructions 
1t K represents an expression. 
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2. The following complete definition redefines single--address long jump JP as the EQ jump, which 
is faster than JP on the 6600 Computer System. 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


II 

IB 

ho 






JPQ 

OPDEF 

PI 

I 

1 



EQ 

ENOM 

PI 

1 

1 


Each subsequent JP instruction that matches the syntax JPQ is assembled as an EQ. A JP 
instruction having a different syntax, such as the following, is not affected. 


Location 

Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 




i 

M 

IB 

ho 

100H2 

0233000005 ♦ 



JP 

nif+ALPHft 1 


3. The following definition traps all floating point double-precis ion subtraction instructions 

(DXi Xj-Xk) and jumps to an error-check routine for debugging. I, J, and K are substitutable 
parameters used within the definition. 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


!l 

IB 

ho 



DXV-V 

OPDEF 

T, J,K 

-1- 

1 




• 


1 

I 




RJ 

FNOM 

TKOirT 

1 

1 

1 



4. The following sequence causes RXi K to be defined as AXi K. It does not affect the standard 
RXi instructions involving registers. 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


II 

18 ho 


RXQ 

OPDEF 

flX.Pl 

FNDH 

P1»P2 1 

P2 ' 

1 

1 


5.4.7 OPDEF CALL 

An opdef call resembles a CPU mnemonic machine instruction. The mnemonic code, quantity and 
sequence of registers, arithmetic operators, and expressions (excluding operators within the expressions) 
must match the syntax described in the OPDEF for the definition to be called. 
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NOTE 


U' the Q in a descriptor is combined with rej>'ister letters, 
a plus or minus must precede an expression in the call* 


OPDEF Syntax 

Call 



JPQ 

JP 

K 

Not combined 

JPBQ 

JP 

Bn^K 

Combined 

JPB.Q 

JP 

Bn, K 

Not combined 

JPX/XQ 

JP 

Xn/XniK 

Combined 


An OPDEF call can occui" any place after the definition is saved. In substituting parameters, the 
assembler uses only the register values given in the call. It docs not substitute the i^egister designators. 

A location symbol on the opdef call line forces the first word of generated code upper. The location field 
symbol is assigned the current value of the current location counter after the force upper, A location 
field on the line in the definition that generates code is assigned the same value. If the location field of 
the opdef call does not contain a symbol, the manner of the force upper is a function of the first code- 
generating instruction in the expansion. If the call location field and the code-gene rating Instruction 
field both contain symbols they are assigned the same value. 

Only a line having the correct syntax calls the definition. 

Examples: 

The following opdef defines an instruction having the syntax IXX/X, On the call, the assembler 
substitutes 3 , 4 , and DIV (not X3, X4, and X. DIV) for PI, P2, and P3, respectively. 


Location Code Generated 


lOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


11 

ie 

30 



IXX/X 

OPDEF 

PlfP2,P3 





PX.P2 

X.P2 





PX*P3 

X.P3 





NX*P2 

X.P2tB4 





NX.P3 

X.P3»B4 





FX.Pi 

X.P2/X.P3 





UX.Pl 

X.PlfB4 





LX.PI 

X.Pl»B4 





endm 

a 






a 

a 

1x3 

X4/X.DIV, 


, ' ' 27404 ' 



iPx#S?fx 

.4 0 . • 

1x3, .'1 

27000 : 



PX.DIV 

X.DIV ■ 

■1X3 , 

^7' 24444 ' ' 



NX.4‘ X 

»4»B4 ‘ 

■ ,1X3' 

^4040 



NX.DIV 

X.blV»B4 

1X3 ' 'VI 

44340 



FX.3 

X.4/X.D1V 

1X3 

^6343 



UX.3 X 

.3,04 

,1X3 , .1 

30 



LX.3 X 

.3,B4 

"'1X3 ■; 




ENDM 


"•1X3 . 
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The following OPDEF selectively traps the SXi Xj-fBk instructions. 


Definition: 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

_l 


11 

18 ho 


SXK+B 

OPDEF 

• 

• 

m 

ENOH 

I>JiK 1 

1 

1 

1 

1 


Statements that call the definition: 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


11 

IB ho 

St 

SYM 

atements th 

SX3 

• 

• 

• 

SX.NN 

at do not 

X1+R2 I 

i 

1 

1 

X6+B.XXX j 

call the definition: 


LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


11 

IB ho 



SX5 

SX6 

SX.Y 

SY 

X4 INO R DESIGNATOR OR +. 

( 

B3+X4 IrEGISTEPS INTERCHANGED 

1 

03 INO X DESIGNATOR OR OPERAND 

X4+-B4 [HNEHONtC CODE NOT SX. 


5.4,8 LOCAL—LOCAL SYMBOLS 

One or more LOCAL instructions that list symbols local to the definition optionally follows the MACRO, 
MACROE, or OPDEF pseudo instruction. The only lines that can separate the first header statement 
from LOCAL are comment lines. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


LOCAL 

symbols 


symbols List of local symbols. Each symbol must begin with an alphabetic character. 

Symbols must be separated by and must not include the following characters: 

+ -*/()$=, or . 
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A bhnik terminates the list. The assembler ij*aores a null symbel piajdueed by 
twu acljaeent separators or by a separator at the end ui' tlie list. CthMT'ASS if^nores 
the use of a substitutable i)arameter name» another local symbol name, dv a name 
beginning'with a number in the local symbol list. A local symbol cannot be 1*''^}, 
ENDD, ENDM, IRP, or LOCAL. The total number of unitjue parameter names and 
local symbols must not exceed ij;! for any one macro or tjlM)l\K definition. 

A location field symbol, if present, is ignored. 

A symbol in the list is considered local to the macro; that is, it is known only within the macro definition. 
On each expansion of the macro, COMPASS creates a new symbol for each local svml3o] and substitutes it 
for each occurrence of the local symbol in the definition tolher than in comment lines identified by ■' in 
column 1). Thus, invented symbols replace LOCAL-nnmed s.\'ml>o1s wherever they appear in a macro 
definition in a manner similar to the way substitutable parameters are replaced. The chief difference 
between substitutable parameters and local symbols is that CCfMl^ASS automatically .supplies the value C 
(cliaracter string to be substituted for) a local symbol so that it Is unique for each macro call. 

A user passes a local symbol to inner macro definitions or inner macro calls when he does not declare 
the symbol local in any of the inner definitions saved or callecL That is, a symbol declared local in a 
macro can be referred to in any inner macro that does not also declare it as local (see example 2). 

A symbol not defined as local is accessible from outside the macro definition. An invented symbol is 
qualified if defined while in a QUAL block* It is not listed in the symbolic reference table. Blanks 
are preserved in a line containing a substituted symbol; COMPASS makes no attempt to change the 
structure of the line* 

On the listing, each invented symbol is shown as tisym, where sjrni is unique for each local symbol in 
the subprogram. For example, if the sionbol A is declared local to the macro, the subprogram can 
define a different symbol A elsewhere. 

Examples: 

1. In the following example, C is local to macro ABC and is passed to inner macro definitions, 

In the definition, each occurrence of formal parameter A is replaced by the parameter mark 
7701; each occurrence of B by the parameter mark 7702, and each occurrence of C by the 
parameter mark 7703. Then, when ABC is called, COMPASS assigns invented symbol 
flOOOOOl to C and replaces each occurrence of 7703 in definitions ABC and X^'Z. 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


11 

16 

ho 



ABC 

MACRO 

At B 

1 




LOCAL 

C 

1 



C 

R5S 

lOB 

1 



• 

■ 


1 



• 

• 


( 

DEFINITION 


• 

• 



|0F ABC 


X YZ 

MACRO 

D 

1 

1 




5TA1 

C 

. iDFFINITION 




• 


tOF XYZ 



i 

i 

ENOM 


] 

1 


1 

'^'^-uuuooi 

.. ABC . 

MACRO 

5A1 

LNDM;;, 

.. 

f iOH 

'0 ^ 
yt.t-OOpOUi j 

1 

i 1 

^ [DEFINITION 
[ j OF XYZ 

EXPANSION ' 1 

^ OF ABC 




1 



ABC- 

ABC 

ABC 

ABC 
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2. In the following- example, C local to each level. Note how this example dilTert^ IVom the 
preceding one. 



IQCATtON 

OPERATION 

variable 


COMMENTS 

r 


n 

ia 


ho 


nro 

MACRO 

A.R 


-f--- 

1 ) 



LCIOAL 

c 


1 1 


c 

BSS 

tOR 


t 

1 ! 


■ 

« 



1 [ OfTFIiMirrO'-i 


• 

■ 



; ! OF 


Y7A 

MACRO 



, 1 1 
i 



LOCAL 

r 


i 1 



SAl 

r 


:DrFINITrON 1 



• 



"jOF YZA , 


C 

• 

BS»;z 

1 


1 1 

^ 1 



FNOM 


J 

t J 


On the call to BCD, the assembler replaces each occurrence of C with the invented symbol, 
fl000002 including the use of the symbol in the LOCAL instruction for macro XVZ, 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


It 

IB 

30 



dCU 

b • O 

EaPANSIO.N of aCU 




bSS \ 1,0 b.: 

'v':'/ o:'^:bcd 





• -Vr.-iv • ::i:BC0' 




i’+ ^000002 

•:.v. ^ "J'/ 



sAi;.^ 

• ti^OOOU02 ■ 

^ DEF in;tION" 


t + OOOOO/;; 


bSSZ ''iy:']. 

• /■:: i'B'CD 



ENDMi;.”- 


. / y'/ '''/'bco 


Finally, on a call to YZA, P000002 is defined as local and the assembler replaces each 
11000002 with another invented symbol. Thus, each reference to C in the source code SAl 
instruction does not I’esult in a reference to the BSS in the outer macro. 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


11 

IB 

30 



t i.O'O b y 3 

YZA 

■'tWPH.',';; 

t*000003 

■B55Z-,; ; 

tAPANSlON OF YZA 
j yytyi. . def.I-M iTi ON ■ 

YZA 

YZA 


5.4.9 IRP - INDEFINITELY REPEATED PARAMETER 


An IRP pseudo instruction in a macro definition signals the beginning or end of a sequence of code to be 
assembled repeatedly with one parameter v^aried with each repetition. 

It has two formats: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


IRP 

parameter 


IRP 
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The first Ibnn inlruLluccr the *^nfjuenro niicl names the substJlutable parameter; the second form 
terminates the repeated sequence. In cither fomi, a location field symbol, ifiircsent, is ii^norcd. 

The parameter name must be listed ns a substitutable parameter on the MACHO or .MACIlOK pscarlo 
instruction for the definition. 


On the macro call, the indefinitely repeated parameter consists of one or mure subparameters enclosed 
by parentheses and separated by commas. The assembler assembles the sequence for each subparameler; 
the niunber of copies of the sequence depends on the number of subparameters (none at all when the 
actual parameter is null). Wlien the list of subparameters is cNhausted, the assembler continues with 
the next line in the definition. If the named substitutable [larameter does not occur between the two 
IRP instructions, the assembler repeats the code unchan^'ed for each subparameter piwkled in the call. 

An IHP outside of the range of a macro has no effect on assembly other than to be inelucled in statement 
counts. 

IF-skips of IRP sequences should be controlled by instruction bracket names rather Ihan sLidement 
counts because IRP exi^ansions are done even when an IF-skip is used and because the numljcr ol 
statements generated by IRP is variable. 

Anything that can be done with an IRP pair can be done with ECHO and ENDD. IRP is raster at nsscmbl\' 
time but ECHO is more flexible (it is not expanded during IF-skips, allows multiple arguments, and 
can be nested). IRP should be used when greater speed is desired and the ex|ianded capabilities of 
ECHO are not needed. 

Examples; 

1. Repeat sequence within macro 


2? . Sn GQO'OOOO" 

*' • ' ' 7261 000000 
^ 160000000 ''. 

. SllOOOOOOO' 

?4 7?6ibooooo : ' . 

. ,.5160000000 
51 lOOODOO'b 

7261000000 
26 51#^d6gG.003 • 


LOCATION 


?AB 


OPERATION 


VARIABLE 


COMMENTS 


13Q 


MACRO 

IRP 

SA) 

ARG.B 

ARG 

ARG 

1 

1 

} 

definit 

5X6 

5A6 

IRP 

ENDM 

• 

X 1 ♦R 

APG 

PEPEATED 

tSEOiJEWCE 

OF 

ZA6 

• 

ZAR 

(J,K,L)tCON 

i 

ZAB 

.. J 

IRD' ' 


'! - .v' 

•■iZA'i;' ' 

.1 

5A1 

WmMsXiMk 

r' .. 

^ZAR 


SXfa 

xi+con'' 

j , 

' ;:zAB'> ' 

• 1 

SA6 

j. : ; 

j , . 

.••,:'ZAB\', 

.] 

SAl 

K'. ' T 


-.ZABv; .. 

. .1 

5X6 

xl + CON ':V' 

! .•' ■' ''=? ' 

•:yZ'AB'--. 

.1 

5A6 


■! * ’ 

-'•ZAB : 

• 1 

5A1-. 

L ... 

'i ■■ 

"k'ZAB' . 

• 1 

SX6 . • , , 

XH'CON- 

j • 

•■'yZABV 

•1 

SA6 


'1, ’ ■ ■ - ■ h- 

-:zab' 

' .1 

IRP 

F Ki DM 


1 . . ■ - ' 

,'VZA8 . 

.1 
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2. Assign symbol at every lOOg words of zeroed storage; 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

T 


tl 

IB 

30 


Bur 

PI 

b'* ' h 

S‘ ,' B 

USE 

MACRO 

IRP 

BSSZ 

IRP 

ENOM 

BUF. 

IRP ' \ 
5SZ } 

SSI : 1 
S5Z . 1 

ssz'-Sffii 

IRP' /'■ 
ENDM 

STORAGE 

PI 

PI 

lOOB 

(P,Q,R»S*T) 

PfQVRiSft 

boB^^ 

bOB = 
ooB 

OOB . 

OPB. 

7 . 7 ,, 7 BUF. -v"';'! 

BUF .1 

•••'. '.BUF'.V. : 

: 'BUF,;:-‘ ■' >1 

. ,: ■, ; 0UF:i'':;" ' .'il 

.BUF'.'. : ■ '.I 
■' -.'BUF-'.1 


5.5 SYSTEM MACRO AND OPDEF DEFINITIONS 


Definitions of such general usefulness that they should be available to any prugrain without each 
program defining them can be placed on the system text file as system macros or can be placed cju 
a file accessible through an XTEXT pseudo instruction. 


System macros provide for such system functions as reading and writing files and specifying pa ram etc 
for file environment tables, etc. Systems macro definitions are available to COMPASS for each 
assembly. The programmer can use a macro call for a system macro at any time In his program. 
Descriptions of system macros are given in the operating system reference manual. 

Systems definitions can include any Legal macro or opdef definition. An expansion of a call for a 
system definition is not normally included on the assembler listing. Use of the S option of the LIST 
pseudo instruction (Section 4.11.1) enables listing of expansions of system definitions. 
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OPERATION CODE TABLE MANAGEMENT 


6 


The COMPASS operation code table contains the information that COMPASS requires for interpreting legal 
operation field entries for COMPASS instructions. 

When assembly begins, the operation code table contains these entries: 

Pseudo instructions (except LOCAL) 

CPU symbolic instructions (chapter 8) 

CMU symbolic instructions (chapter 8) 

PPU symbolic instructions (chapter 9) 

System macro and opdef definitions 


The MACRO, MACROE, and OPDEF pseudo instructions (chapter 5) cause entries to be made in this table. 
In addition, the programmer has the capability of creating entries through the following instructions 
discussed later in this chapter: 


CPOP 

PPOP 

OPSYN 

CPSYN 


CPU operation 
PPU operation 

Synonymous PPU or pseudo operation or macro 
Synonymous CPU operation or opdef 


If a new entry redefines an instruction already in the table, the obsolete entry is not physically removed 
from the table. Instead, it is saved so that the table can be reconstructed between assemblies. COMPASS 
reconstructs the operation code table using all the original system macros, opdefs, pseudo instructions, and 
symbolic machine instructions. No programmer-created entry is preserved from assembly to assembly. 

The number of entries in the table is limited to 4123. 

The only pseudo instructions that logically remove entries from the operation code table are PURGMAC 
and PURGDEF. 

Entries in the operation code table are in two distinct formats permitting a logical division of the table. 
One type of entry permits identification of an instruction by finding a match for the contents of the 
operation field, thus, it provides mnemonic recognition. The other type of entry is looked at only if the 
search for a mnemonic operator fails to yield a match during a CPU assembly. 

This type of entry provides for recognition of an instruction according to its syntax. COMPASS analyzes 
the statement to be interpreted, determines the syntax of the operation and variable sub fields, and again 
searches the table. 


60492600 E 


6-1 









Instructions are recognized in the mnemonic search and the information provided to the assembler for each 
instruction are as follows: 

Pseudo instructions The entry contains addresses to routines that perform 

pass one and pass two operations. 

PPU symbolic instructions The entry describes the format of the instructions to be 

assembled. 

Instructions described through PPOP The entry describes the format of the instruction to be 

assembled. 

Macro instructions The entry directs the assembler to the location of the 

saved definition. 

Instructions described through OPSYN The entry is a copy of the synonymous entry. 

For a PPU assembly, a failure to find an entry for a mnemonic operator causes an operation code error. 

For a CPU assembly, however, if the search for the mnemonic operator does not yield a match, COMPASS 
searches the operation code table again for an entry with a matching syntax. Instructions recognized in the 
syntactical search and the information provided to the assembler for each instruction are as follows: 

CPU symbolic instructions The entry describes the format of the CPU instruction to 

be assembled. 

Instructions described through CPOP The entry describes the format of the CPU instruction to 

be assembled. 

Instructions defined through OPDEF The entry directs the assembler to the location of the 

definition. 

Instructions described through CPSYN The entry is a copy of the synonymous instruction 

The action taken depends on the synonymous entry. 

If, following the second search of the operation code table, the statement still has not been identified, the 
assembler takes the following action: 

I For a PPU assembly, it generates a 24- or 32-bit instruction of which the first 12 or 16 bits are zero. 

For a CPU assembly, it generates a 30-bit zero instruction. 

Although OPSYN and CPSYN pseudo instructions provide a means of rendering more than one instruction 
synonymous, only instructions of the same type can become synonymous. The logical division of the table 
between the two types of entries prevents mnemonically identified instructions from being made 
synonymous with syntactically identified instructions. 

When a MACRO, MACROE, PPOP, or OPSYN creates an entry for a mnemonic noine that is already in the 
table for a different instruction, the new entry takes precedence over the old entry. Similarly, when a 
OPDEF, CPOP, or CPSYN redescribes a syntax already in the table for a different instruction, the new 
entry takes precedence over the old entry. As a result, the order of precedence for operation field 
recognition is, from highest to lowest: 

1. Programmer-created entries for mnemonically identified instructions. 
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2. System macros, pseudo instructions, PPU symbolic machine instructions, and CMV 
instructions other than the IM instruction. 

3. Programmer-created entries for syntactically identified instructions 

4. CPU symbolic instructions and the CMU IM instruction 

Example: 


The following example illustrates a special case in which a macro name talces precedence over one 
form of a machine instruction, i. e., the form using SB4 as an operation code. 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


T1 

18 

ho 





1 

5?e4 

MACRO 1 

Pl,P2 

1 DEFINE MACRO NAMED SDA 


ENOM 


SB4 




Al+ABLE 


Ali^ARLE 


CALL TO MACPO, NOT CPU IN*=T-?UrTION 


MACHINE INSTRUCTTOM 


SB4 


OPSYN 


NIL 


,ni*?ABLCS HACRP BUT DOFS NOT 
I RESTORE NORMAL USE CF SR4 
I AS AN OPEPATION CODE. ^VFl‘ IF 
I IT WERE REOEFTNED WITH OPOFF 
; IT WOULD NOT RE RFC0GNI7ED, 

THE MACRO FORM ALWAYS TAKFc 
'PRECEDENCE. 


PURGMAC; Sn4 


RESTORES NORMAL USE OF SR4 


6.1 MNEMONICALLY IDENTIFIED INSTRUCTIONS 

Mnemonically identified instructions include all pseudo instructions, macro instructions, and PPU 
symbolic instructions whether system or programmer defined. PPOP, OPSYN, NIL, and PURGAIAC 
provide the programmer with a means of creating or removing operation code table entries that are in 
the mnemonically identified format. 


6.1.1 PPOP - PPU OPERATION CODE 

The PPOP pseudo instruction defines the operation and variable fields of a PPU symbolic machine 
instruction and creates an operation code table entry for the instruction. COMPASS generates an 
octal machine instruction of the defined format whenever the PPU insti'uction described by the PPOP 
instruction is used. If the operation code table already contains an entry for the name, the new 
definition talces precedence over the old during assembly of the subprogram or until it is redefined. 
No error is flagged. Any illegal parameter in PPOP causes COMPASS to ignore the PPOP and issue 
a 7-type error flag. 


(i-:i 
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Format: 


LOCATION 

OPERATION 

VARIABLE subfields 

name 

PPOP 

ctl, val, type 


name Mnemonic name, 1 through 8 characters 

ctl Control of instruction assembly 

ctl Significance 

0 Illegal; if used, COMPASS ignores the PPOP 

1 24-bit instruction with 12-bit address and no indexing 

2 12-bit instruction with signed relative address or absolute address 
(e.g., UJN) 

3 24-bit instruction with 18-bit address (e.g*, LDC) 

4 12-bit instruction with 6-bit address (e.g., LDN) 

5 24-bit instruction with 12-bit address and optional indexing (e.g., LDM) 

6 12-bit instruction with signed relative address (e.g., SEN) 

7 24-bit instruction with 12-bit address and required second field (e.g., 

lAM) 

val An evaluatable expression specifying the octal 4-digit operation c^e value; usually, 

only the two leftmost digits are significant. If the assembly base is M, the field is 
assumed to be octal. 

type An evaluatable expression specifying an integer value that COMPASS interprets as 

follows: 

6 Restrict the instruction being defined to the CYBER 180 Series, 
CYBER 170 Series, CYBER 70/Models 71, 72, 73, and 74; COMPASS 
sets an error flag if the instruction being defined is used in a CYBER 
70/Model 76 PPU assembly. 

7 Restrict the instruction being defined to the CYBER 70/Model 76; 
COMPASS sets an error flag if the instruction being defined is used in 
a CYBER 180 Series, CYBER 170 Series, CYBER 70/Models 71, 72, 73, 
and 74 PPU assembly. 

other or 

omitted The instruction is not restricted to either machine type. If the base is 
M, type is assumed to be octal. If type is omitted, the comma 
preceding it can be omitted also. 
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Example: 


7311 


Code Generated 


01*0 


40 


5415 0040 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


n 

IB 

ho 



pptJIDH 

r»aSF 

n 

“i.. 

1 

1 



• 


1 



• 


1 



m 


1 


LH 

rnrj 

IS 



C 


un 

1 


STM 

PROP 

‘itoo+Lfl 

1 



• 


i 



• 


1 



« 


1 



<sTM 

r 

1 


6.K2 OPSYN - SYNONYMOUS MNEMONIC OPERATION 

The OPSYN pseudo instruction malces a name in the location field of the OPSYN synonymous with the 
macro, pseudo instruction or PPU mnemonic name specified in the variable field. The size of the 
operation code table is the only limit to the number of instructions that can be made synonymous. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

name^ 

OPSYN 

name2 


The name in the variable subfield must be previously defined as a standard instruction code. After an 
OPSYN, either name produces equivalent results. If the location field specifies a previously defined 
macro or operation code, the new definition takes precedence over the old without notification. Thus, 
a macro defined by a name that is subsequently used in an OPSYN location field is not called when 
the macro name is used in the operation field. The instruction actually called is the instruction 
named in the variable subfield of the OPSYN. On the other hand, the old macro definition is not lost 
and can be restored by purging the new definition with PURGMAC. 


Example: 


1. An operation named CALL is synonymous with RJM. 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 



1 


11 

IB 

ho 




CALL 

OPSYN 

• 

RJM 

-1- 

1 

1 

r 





• 

CALL 

=XSUBR= 

1 

1 

•PPOOUCES 

Ias if it 

SAME 

WERE 

RESULTS 

AN RJM 
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2. In the following example, a programmer wishes to use a macro named LJM for part of the 
program and use the real LJM for the remainder of the program. 


1 

LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


n 

IB 

ho 


LJM. 

OPSYN 

LJM 

SAVE ORIGINAL DEFINITION AS LJM 



PURGHAC 

• 

LJM 

[purge original DEFINITION 

1 


LJH 

. 

MACRO 

a 

XX 

1 

1 

1 

1 


LJM 

■ 

• 

CNDH 


1 

1 



a 

« 


j 

" jCOOE USING LJM MACRO 


LJM 

a 

OPSYN 

LJH. - 

[restores original LJM 



a 

• i 

1 

1 

"|C0nE USING ORIGINAL LJM 



a j 

J 



6.1.3 NIL-DO NOTHING PSEUDO INSTRUCTION 

The NIL pseudo instruction resembles a no-op; it produces no code and conveys no information to the 
assembler. It is primarily designed for disabling a macro; it cannot be used with CPSYN. The 
following instructions could be used in place of NIL as nil instructions: 

ENDM 

ENDD 

ENDIF 

IRP 

Format: 


LOCATION 

OPERATION 

VARIABLE SUQFIEIDS 


NIL 



A location field symbol if present is ignored. 


Example: 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


11 

18 

ho 

— 

MACK 

OPSYN 

NIL 

— 1-- 

1 



a 


1 



. 


1 

1 


TAG 

a 

MACK 

A,B,&,73 

1 

1 



■ 


i 

1 



- 


1 
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The assembler interprets each call to MACK as a NIL instruction. TAG is not defined because it 
becomes the location field symbol for NIL when the statement is assembled. 


6.1.4 PURGMAC—PURGE MACROS 

The PURGMAC pseudo instruction provides a means of disabling operation code entries for the named 
instructions for the duration of the current assembly. 


Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


PURGMAC 

name^, namcgi •.., name^^ 


name. 

1 


Names of mnemonic operation codes for macro definitions, pseudo instructions, 
or PPU instructions. 


A location field symbol if present is ignored. 

6.2 SYNTACTICALLY IDENTIFIED INSTRUCTIONS 

Syntactically identified instructions apply to CPU assemblies only. The CPOP and CPSYN pseudo 
instructions create operation code table entries for instructions that are to be identified through 
recognition of their syntax, rather than through the contents of the operation field only. 


6.2.1 CPOP-CPU OPERATION CODE 

The CPOP pseudo instruction describes the syntax of a new CPU symbolic machine instruction and 
creates an operation code table entry for the instruction. An instruction of the defined format is 
generated whenever the CPU instruction described by the CPOP instruction is used. If the operation 
code table already contains an entry for the instruction, the new definition takes precedence over the 
old during assembly of the subprogram. Any illegal parameter in CPOP causes COiMPASS to ignore 
the CPOP and issue an error flag. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

sytx 

CPOP 

ctl, val,reg,type 


sytx The syntax consists of a mnemonic operator and variable field descriptors. 

The mnemonic operator consists of two characters. The first can be any 
character except blank. The second character can be a register designator: 

A, B, or X, in which case, the operation field of the instruction is recognized 
as cAn, cXn, or cBn, (c is a unique character; n is 0-7); or the second 
character can be any other character except blank, in which case the operation 
field of the instruction is recognized simply by a two-character mnemonic, such 
. as EQ. 
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The variable field descriptors define the order of appearance of all registers, 
expressions, and subfield separators that comprise the variable field of the 
instruction being described. It consists of none, one, two, or three of the 
following 22 subfield descriptors, Q represents an expression. An r represents 
a register letter (A, B, or X). A comma separates two descriptors; a blank 
terminates the syntax. 


void 

r 

-r 




*■ 1*^2 

>* 1/^2 


T -r 
1 2 


-^r^2 


Q 

rQ 


-rQ 

ri+r2Q 

Ti^r^Q 

r^*r^Q 


-r^^r^Q 

Tj/rgQ 

-rj/rgQ 

ri-r2Q 


-ri-r2Q 


For example, to describe -X3*B1, the descriptor, written as -X*B whereas, to 

describe B2+ALPHA, the descriptor rQ would be written as BQ. 


ctl 


Control of instruction assembly. 


ctl 


Significance 


0 

1 

2 

3 

4 

5 

6 

7 


15-bit instruction 
30-bit instruction 

15-bit instruction, force upper before assembly 

30-bit instruction, force upper before assembly 

15 bit instruction, force upper after assembly 

30-bit instruction, force upper after assembly 

15-bit instruction, force upper before and after 
assembly 

30-bit instruction, force upper before and after 
assembly 
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val 


peg 


type 


Example: 


An evaluatable expression specifying a 9-bit operation code: if the base is M, val is 
assumed to be octal* 

Three octal digits specifying the order from left to right into which register numbers are 
to be inserted into the i, j, k portions of a 15-bit instruction, or into the i and j portions 
of a 30-bit instruction. If the assembly base is M, reg is assumed to be octal* 

1 Register number obtained from operation field 

2 Number of second register or only register in variable 

field 

3 Number of first two registers in variable field 

0 Set field to 0 

An evaluatable expression specifying an integer value that COMPASS interprets as 
follows: 

6 Restrict the instruction being defined to the 6000 Series, 

CYBER 180 Series, CYBER 170 Series, and CYBER 
70/Models 71, 72, 73, and 74; COMPASS sets an error 
flag if the instruction being defined is used when 
MACHINE 7 has been specified. 

7 Restrict the instruction being defined to the 7600 or the 

CYBER 70/Model 76; COMPASS sets an error flag if the 
instruction being defined is used when MACHINE 6 has 
been specified. 

other 

or 

omitted The instruction is not restricted to a machine type. 

If base is M, type is assumed to be octal. If type is omitted, the comma preceding it can 
be omitted also. 


722 


Code Generated 


tOCATION 

OPERATION 

VARIABLE 

COMMENTS 


• 

1 


11 

m 

ho 




SAx + fj 

LI-CJH 

0 tS30L}tl3^d 

IDCFINES iAl 

XJ+BK 



SXXL; 

! 

CHOP 

i,/2aij,i2ua 

[ucFINtS SXI 

1 

1 

XjfK 

‘i3r3i 



• 

X3*tll 

! 

1 

1 

1 


^231000003 


1 AG 


X 1+3 

1 

1 
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6.2.2 CPSYN ^ SYNONYMOUS CPU INSTRUCTION 


The CPSYN pfceuclo instruction renders an instruction with the syntax given in the h)cation field 
synonjmious with the instruction having the syntax specified in the variable field. The only limit to 
the number of CPU instructions that can be made synonymous is the size of the operatiem code table 
(4123 entries). 

Format; 


IOCA1ION 

OPEJIATION 

VARIAfilE SUBFIEIDS 

sytxj 

CPSYN 

sytXg 


sytx Syntax of a CPU Instruction (see CPf)P for legal forms). If this syntax is 

^ already in the operation code lablCi the table entry for sytx^ takes precedence 

over the old table entry for sylx^ without notification. 

sytXg Syntax of a CPU instruction for which there must he an entr>- in the oj^eration 

code table. Following* the CPSYN, an Instruction in either sytx^ or •‘^ytx^ 
produces an octal instruction of the format described by the entry for sytx.^. 

6.2.3 PURGDEF — PURGE CPU OPERATION CODE 

The PURGDEF pseudo instruction provides a means of disabling syntactically-identified operation code 

entries for the duration of the current assembly. 

Format: 


LOCATION 

OPEJIATION 

VARIABLE SUBFIELOS 


PURGDEF 

sytx 


sytx Syntax of a CPU instruction (see CPOP for legal forms). 

A location field symbol, if present, is ignored. 
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MICROS 


7 


The COMPASS micro capability enables the programmer to symbolically refer to a defined character 
string. When used in conjunction with IFC, DUP, STOPDUP, and SET pseudo instructions, micro 
strings provide for varied manipulation of character strings — testing for a particular character, 
counting characters, concatenation of strings, etc. 


Use of a micro definition requires two steps: definition of the character string, and substitution. In 
this discussion, substitution rather than definition is discussed first so that the reader has a belter 
understanding of how a definition is used when it is described. 


7.1 MICRO SUBSTITUTION 

^Vherever a micro name between micro marks (7^) occurs in a statement other than a comment 
line (* in column 1), the assembler substitutes the micro before it interprets the statement. If 
column 72 of the last statement read is exceeded as a result of micro substitution, the assembler creates 
up to a maximum of 9 continuation statements, beyond which it discards excess characters without noti¬ 
fication on the listing. No replacement takes place if the micro name is unknown or if one of the micro 
marks has been omitted. If the micro name is unloiown, the assembler flags a nonfatal assembly error. 
If the micro name is null (that is, the two micro marks are adjacent), fhQ,n 

1. Both micro marks are deleted, uud 

2. No error flag is set 


Example: 

A micro identified as NAM is defined as the 7 characters: 
ADD*?ESS 


A reference to NAM is in the variable field of a line: 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


11 

IB 

30 


LOC 

SAl 




However, before the line is interpreted, COMPASS substitutes the definition for NAM producing the 
following line: 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


M 

IB 

ho 


Lon 

SAl 

ADDRESS+4 | 


NOTE 
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Unless the A option of the LIST pseudo instruction is 
enabled, the listing depicts the instruction as it was 
before the substitution took place. 
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7.2 MICRO DEFINITION 

Pseudo instructions specifically designed for the purpose of defining micros are: MICRO, OCTMIC and 
DECMIC. In addition, the following pseudo instructions optionally define micros: BASE, CODE, and 
QUAL. Also, system or built'-in micros are automatically defined by COMPASS at the start of each 
subprogram assembly. 

,7.2.1 MICRO-DEFINE MICRO 

The MICRO pseudo instruction defines a character siring and assigns a name to that string. 

Format: 


LOCATION 

OPERATION 

_ t - 

VARIABLE SUBFIfLDS 

micname 

MICRO 

, Ug , dstringd 


micname Name by which definition is called; 1-8 characters 


Absolute evaluatable expression specifying starting character in string; when the 
base is M, COMPASS assumes that n^ is decimal. 

Absolute evaluatable expression specifying number of characters; when the base 
is M, COMPASS assumes that n^ is decimal. 

dstringd Delimited character string. The delimiter d is a character not used in the 

string. 


Counting the first character after d as character 1, the assembler forms the string by extracting 
characters starting with character If the second delimiting character occurs before count n 2 is 
exhausted, the defined string terminates at that point. If is greater than zero and n 2 is omitted, zero, 
or negative, the defined string includes all the characters from to the closing delimiter (see second 
example). 

If is omitted, zero, or negative, the defined string is empty; no substitution takes place when the micro 
name is referred to. That is, n 2 and the character string are ignored. 

A previously defined micro can be a part of a micro definition; one micro can be defined as a substring 
of another (see third example). 

A micro can combine previously defined micros or can be a subset of another- Also, a micro defined 
originally as one character string can be redefined subsequently with a different character string. After 
the redefinition, the original character string is inaccessible. 

If or n2 is negative, tlie assembler generates a 7-type error. 

Examples: 


1. The following MICRO defines NAME as the 19 characters beginning with A and ending with G. 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


n 

IB ho 


N OHE 

MICRO 

1,19,♦ALPHANUMERIC STPING* 
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7.2.2 DECMIC DECIMAL MICRO 


i r-ing* a decimal conversion, the DECMIC pseudo instruction converts the e.\'pressi()n into u chanieler 
siring to be saved under the name specified. 


Format; 


LOCATION 

OPERATION 

variable subfields 

micname 

DECMIC 

aexp,n 


micname Name by wlaich definition is called; 1-8 characters 

aexjD Absolute evaluatal3le ex]5ression 

n Optional absolute evaluatable expression specifying number of cliaracters 

in the defined string. The defined string is a maximum of 10 characters 
regardless of the magnitude of n. When base is COMPASS assumes that 
n is decimal 

If n is omitted or has a zero value, the micro contains the number of characters 
indicated by the conversion to a maximum of 10 characters. If the converted 
exiDression has more than n (or 10) digits, the most significant digits are 
truncated. If the value has fewer than n digits, the string is right justified and 
filled with leading zeros. All numbers are treated ns positive. 

Example: 

B has the value 1024 decimal or 2000 octal before conversion. 



LOCATION 

OPERATION 

variable 

COMMENTS 

1 


]] 

IB 

3D 


V 

DECMIC 

B,6 



SYMBL 

MICRO 

STORAGE NEEDED* 


SVi^BL 

micro; : 

1 p pip 2 4; : s j' b R' a g E : ■:«)) E E; b | b ^ 


7.2.3 OCTMIC - OCTAL MICRO 

Using Lin octal conversion, the OCT.MIC pseudo instruction converts Ihe value of the exjiression iiUn a 
character string to be saved under the name specified. 

( 

( 
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Format: 


LOCATION OPERATION VARIABLE SUBFIELDS 

micname OCTMIC aex]i,n 

micimme Name by which definition is called; 1-8 characters 

aexp Absolute evaluatable expression 

n Optional absolute evaluatable expression sped !y in” nundjcr ol clTarnders 

in the string. Tlie denned string is a maximum oT 10 characters regardless 
of the magnitude of n. Wlien base is i\T, COMPASS assumes n as a decimal. 
If n is omitted or has a zero value, the micro contains the number of 
characters indicated by the conversion to a maximum of 10 characters. 

If the converted expression has more than n (or 10) digits, the most significant digits nre truncated. 

If the value has fewer than n digits, the string is right justified and filled with leading zex'os. All 

numbers are treated as positive. 

Example: 


B has the value 1024 decimal or 2000 octal before conversion. 



7.3 PREDEFINED MICRO NAMES 

Several standard micros are predefined by the COMPASS asscunbler. They are available for ever\- 
assembly. The programmer simply writes the micro reference as desired. 

These micros are automatically clefined at the beginning of each assembly, and have the default values 
specified below until they are redefined by the programmer; thereafter, the programmer’s definition 
holds until the start of the next assembly. 

7.3.1 DATE 

The DATE micro contains the current dale in 10 characler.s in one of the rollowlng foi-ms as olUahied 
from the operating system: 

Ayr/mo/dy. or Amo/dy/yr. 

The micro reference is ?^DATEy^u 
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7.3.2 JDATE 


The automatic value of the JDATE micro is five digits yyddd, where yy is the year and ddd is the day 
of year at the time of assembly. Thus, JDATE is the Julian date form of DATE. 

The micro reference is ?^JDATE?^. 


7.3.3 TIME 

The TIME micro contains the current time of day in 10 characters in the following form as obtained 
from the operating system: ^ 

A hr. min. sec. 

The micro reference is t^TIME?^. 

Example: 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


1i 

18 

Uo 

r 


TITLE 

PROGRAM 

ASSEMBLED ON ^DATE# AT#TIHE< 


7.3.4 BASE 

The automatic value of the BASE micro is a single letter D, M, or O, corresponding to the number 
base currently in effect (specified by the most recent BASE pseudo instruction); it is initially D. 

The micro reference is t^BASEt^. 


7.3.5 CODE 

The automatic value of the CODE micro is a single letter A, D, E, O, or I, corresponding to the 
character code currently in effect (specified by the most recent CODE pseudo instruction); it is 
initially D. 

The micro reference is t^CODE?^. 


7.3.6 QUAL 

The automatic value of the QUAL micro is 0 to 8 characters comprising the qualifier symbol 
currently in effect (specified by the most recent QUAL pseudo instruction); it is null initially and 
whenever the blanlc qualifier is in effect. 

The micro reference is ?^QUAL?^. 
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7.3.7 SEQUENCE 


The automatic value of the SEQUENCE micro is 18 characters comprising the sequence field 
(columns 73-90) of the first line of the COMPASS source statement most recently read from the main 
source input file. Thus* if the current statement was read from the main source input file, SEQUENCE 
is the sequence field of the first line of the statement. However, if the current statement is generated 
(i.e*, part of a macro call expansion, DUP expansion, etc.) or is read from a different file via the 
XTEXT pseudo instruction, then SEQUENCE is the sequence field of the first line of the statement most 
recently read from the main source input file. 

The micro reference is ?^SEQUENCE?^. 


7.3.8 MODLEVEL 

The automatic value of the MODLEVEL micro is the value (up to 9 characters) specified by the ML pa¬ 
rameter on the COMPASS control statement. If no ML parameter Is present, the automatic value of the 
MODLEVEL micro is equal to that of the JDATE micro. When COMPASS is called by a compiler to 
process embedded COMPASS subprograms, the automatic value of the MODLEVEL micro is supplied 
by the calling compiler. The MODLEVEL micro is intended to be used when assembling a compiler 
(or COMPASS itself), to provide the compiler modification level to be placed in word 6 of each PRFX 
table in the binary output written by the compiler. 

The micro reference is t^MODLEVEL?^. 


♦ 7.3.9 PCOAAMENT 

The automatic value of the PCOMMENT micro Is the value specified by the PC parameter on the 
COMPASS control statement, with characters truncated from the right or blanks appended to the right, as 
necessary, so that the microns length Is exactly 30 characters. If no PC parameter Is present, the auto¬ 
matic value of the PCOMMENT micro is 30 blanks. When COMPASS is called by a compiler to process 
embedded COMPASS subprograms, the automatic value of the PCOMMENT micro is supplied by the call¬ 
ing compiler. The PCOMMENT micro is intended to be used in a COMMENT pseudo instruction to 
specify words 8 through 10 of the PRFX table In the binary output. It may also be used, In conjunction 
with the *F special symbol, to determine compiler options (debug mode, rounded arithmetic, etc.) in 
effect at the time of assembly. 

The micro reference is j^PCOMMENT?^. 
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CPU SYMBOLIC MACHINE INSTRUCTIONS 


8 


COMPASS recognizes symbolic notation for all central processor unit (CPU) instructions for the CYBER 
180 Series, CYBER 170 Series, CYBER 70 Series, 7600, and 6000 Series. For COMPASS to recognize the 
symbolic notation for models 810, 815, 825, 830, 835, 840, 845, 850, 855, 860, 865, 875, and 990 CPU 
instructions, the programmer must ensure that SYSTEXT is available to the assembler. 

Some instructions in existing COMPASS programs are not valid for execution on models 810, 815, 825, 830, 
835, 840, 845, 850, 855, 860, 865, 875, and 990. To detect these instructions, the programmer can specify 
S=:AipTEXT in the COMPASS control statement. COMPASS prints a listing of the program, flagging the 
invalidated instructions with a type O error. S=AIDTEXT should not be specified if the 8 option is chosen 
for the MACHINE pseudo instruction. 

The assembler identifies each symbolic instruction according to its syntax and generates a one-parcel 
15-bit instruction or a two-parcel 30-bit instruction. The object code for an instruction is generated in the 
block in use when the instruction is encountered. 


8.1 MACHINE INSTRUCTION FORMATS 

Figures 8-1 and 8-2 illustrate the formats for CPU 15-bit and 30-bit instructions generated by the 
assembler. 


14 

8 

5 

2 0 

fm 

— 1 — 1 —I—j_1_ 

i 

_1_1_ 


LuJ 


Figure 8-1. CPU 15-Bit Instruction Format 


29 


23 

20 

17 


0 

fm 

—[—1_L_J_l_ 

i 

_1_1_ 

' i 
_ 1 _ 

_1_i_l_i_ 

K 

J—1—1—1_I_1_1_i_ 

1 1 1 1 1 


Figure 8-2. CPU 30-Bit Instruction Format 


fm 6-bit instruction code 

fmi 9-bit instruction code 

i 3-bit code (O through 7) specifying one of eight designated registers (for example, Ai) 

j 3-bit code (0 through 7) specifying one of eight designated registers (for example, Bj) 

k 3-bit code (0 through 7) specifying one of eight designated registers (for example, Xk) 

K 18-bit integer value used as an operand, address of an operand, or branch destination address 

jk 6-bit integer value specifying a shift count or mask count 

Figure 8-3 illustrates possible arrangements of one- and two-parcel instructions in a 60-bit CPU instruction 
word. Generally, the assembler does not allow a two-parcel instruction to begin in the fourth parcel of a 
word. 
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First 

Parcel (Parcel 0) 

Second 

Parcel (Parcel 1) 

Third 

Parcel (Parcel 2) 

Fourth 

Parcel (Parcel 3) 

15 

15 

15 

15 

59 

44 

29 

14 

01 

30 

15 

15 

59 



29 

14 

Oi 

15 

30 

15 

59 

44 


14 

0 

15 

15 

30 

59 

44 

29 


0( 

30 

30 

59 



29 


0 


Figure 8-3. Arrangements of Instructions in a 60-bit CPU Word 


When a two-parcel instruction begins in the last parcel of a word, the CYBER 170 Models 175, 176,‘ 740, 

I 750, and 760} the CYBER 70 Model 76; and the 7600 execute it as if the instruction word had a fifth parcel 
containing aU zeros. On the CYBER 180 Computer Systems; the CYBER 170 Models 171, 172, 173, 174, 

I 720, 730, 815, 825, 835, 845, 855, 865, and 875; and the CYBER 70 Models 71, 72, and 73; and the 6400, this 
condition causes an error exit. On the 6600 and the CYBER 70 Model 74, the CPU takes the first parcel of 
the current instruction. 

Before it assembles an instruction that must begin in the first parcel (forced upper) and after it assembles 
an instruction that requires the instruction following it to be forced uppa*, the assembler completes a word 
as follows: 

Lower 15 bits remain They are packed with a one-parcel NO (pass) instruction. 

Lower 30 bits remain They are packed with a two-parcel SBO BO+K instruction. 

Lowa* 45 bits remain They are packed with a NO instruction and an SBO BO+K instruction. 


8.2 INSTRUCTION EXECUTION 


8.2.1 6600/6700tAND CYBER 70 MODEL 74 EXECUTION 

After an exchange jump start by a peripheral processor (PP) and CPU program, CPU instructions issue 
automatically in the original sequence, to an 8-word instruction stack. The stack can hold a program loop 
consisting of up to twenty-six 15-bit instructions and one 30-bit instruction. 

Instructions are read from the stack, one at a time, and issued to the functional units (table 8-1) for 
execution. A scoreboard reservation system in CPU control keeps a current log of which units and 
operating registers are reserved for computation results from functional units. 


tThi 


le 6700 also includes a 6400-type central processor unit 


8-2 
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TABLE 8-1, CYBER 70 MODEL 74 AND 6000/7600 FUNCTIONAL UNITS 


Unit 

General Function 

Branch 

Handles all jumps or branches from the program. 

Boolean 

Handles the basic logical operations of transfer, logical product, 
logical sum, and logical difference. 

Shift 

Executes operations basic to shifting. This includes left (circular) 
and right (end-off sign extension) shifting, and normalize, pack, and 
unpack floating point operations. The unit also includes a mask 
generator. 

Floating Add 

Performs single or double precision floating point addition and 
subtraction on floating point operands. 

Long Add 

Performs addition and subtraction of two 60-bit fixed point operands 

Floating Multiply 

Performs single or double precision floating point multiplication on 
floating point operands 

Floating Divide 

Performs single precision floating point division of floating point 
operands; also counts the number of 1 bits in a 60-bit word. 

Increment 

Performs one's complement addition and subtraction of 18-bit operands. 


Each functional unit executes several instructions, but only one at a time. Some branch instructions 
require two units; the second unit receives direction from the branch unit. 

The rate of issuing instructions varies from the maximum of one instruction every 100 nanoseconds (one 
minor cycle). Sustained issuing at this rate may not be possible because of functional unit and CM conflict 
or because of serial rather than simultaneous operation of units. Program run time can be decreased by 
efficient use of the units. Instructions that are not dependent on previous steps may be arranged or nested 
in program areas where they may be executed concurrently with other operations to eliminate dead spots in 
the program and increase the instruction issue rate. 

The following steps summarize instruction issuing and execution: 

An instruction is issued to a function unit when: 

Specified functional unit is not reserved. 

Specified result register is not reserved for a previous result. 

Instructions are issued to functional units at minor cycle intervals when no reservation conflicts are 
present. 

Instruction execution starts in a functional unit when both operands are available. Execution is 
delayed when an operand is a result of a previous step which is not complete. 

No delay occurs between the end of a first unit and the start of a second unit which is waiting for the 
results of the first. 
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After a branch instruction is initiated, no further instructions are issued until the branch has been 
executed. In the execution of a branch instruction, the branch unit uses: 

Increment unit to form the instructions that branch to K + Bi and branch to K if Bi... 

Long add unit to perform the instructions that branch to K if Xj... 

Time spent in the long add or increment units is part of total branch time. 

Read central memory access time is computed from the end of increment unit time to the time an operand 
is available in X operand register. Minimum time is 500 nanoseconds assuming no central memory bank 
conflict. 

8.2.2 CYBER 180 COMPUTER SYSTEMS; CYBER 170 

MODELS 171, 172, 173, 174, 720, 730, 815, 825, 835, 845, AND 855; 

CYBER 70 MODELS 71, 72, AND 73; AND 6200, 6400, 6500 EXECUTION 

The CYBER 180 Computer Systems; the CYBER 170 Models 172, 173, 174, 720, 730, 815, 825, 835, 845, and 
855; the CYBER 70 Models 71, 72, and 73; and the 6200, 6400, and 6500 systems CPU has a unified 
arithmetic unit, rather than separate functional units as in the 6600 system. Instructions in the CPU are 
executed sequentially. 


NOTE 

Unless otherwise stated, the remainder of this section applies to all the models 
listed above, except models 810, 815, 825, 830, 835, 840, 845, 850, and 855. 

For efficient coding in the central processor unit: 

Always attempt to place jump instructions in the upper portion of the instruction word to avoid both 
the additional time for RNI (read next instruction, 2 minor cycles) and the possibility of a memory 
bank conflict with (P + 1). 

Where possible, place load/store instructions in the lower two portions to avoid lengthening execution 
times. 

Reading the next instruction words of a program from central memory, RNI, is partially concurrent with 
instruction execution. RNI is initiated between execution of the first and second instructions of the word 
being processed. Initiating RNI operation requires two minor cycles; the remainder of the RNI is parallel in 
time with execution of the remaining instructions in the word: 
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In calculating execution times, two minor cycles are added to each instruction word in a program to cover 
the RNI initiation time. Exceptions are the return jump and the jump instructions (in which the jump 
condition is met) when they occupy the upper position of the instruction word. Since the times for these 
instructions already include the time required to read the new instruction word at the jump address, no 
additional time is consumed. 

Example: 


Jump to K (met) 

Pass 

Pass 


Add 1 

Add 2 

Load 

Store 


Instruction 


IVIinor Cycles Required 


Jump 

Addl 

RNI Initiation 
Add 2 
Load 
Store 

Total Time 


13 

5 

2 

5 

12 

10 

47 minor cycles 


After RNI is initiated (between the first and second instructions of the word), a minimum of eight minor 
cycles elapses before the next instruction word is available for execution. Even if the lower order positions 
of the word should require less than eight minor cycles, a minimum of eight minor cycles is allowed. 

Example: 


Jump to K 
(not met) 


P H 1 


Pass 


Pass 


8.2.3 CYBER 170 MODELS 175, 176, 740, 750, 760, 865, AND 875; | 

CYBER 70 MODEL 76; AND 7600 EXECUTION 

Execution of an arithmetic or logical machine instruction takes place in one of nine functional units in the 
computation section of the CYBER 170 Models 175, 176, 740, 750, 760, 865, and 875; the CYBER 70 Model | 
76; and the 7600 CPU. Each is a specialized unit with algorithms for a portion of the CPU instruction 
execution. Table 8-2 lists the general function of each unit. A number of functional units can be in 
operation at the same time. 
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TABLE 8-2. CYBER 170 MODELS 175. 176, 740, 750, 760. 865, AND 875; 
CYBER 70 MODEL 76; AND 7600 FUNCTIONAL UNITS 


Unit 

General Function 

Boolean 

Handles the basic logical operations of transfer, logical product, logical 
sum, and logical difference. It also performs the pack and unpack 
floating point operations. 

Shift 

Executes operations basic to shifting. This includes left (circular) 
and right (end-off sign extension) shifting, and mask generation. 

Normalize 

Performs the normalize operations. 

Floating Add 

Perforins single or double precision floating point addition or subtraction 
on floating point operands. 

Long Add 

Performs integer addition or subtraction of two 60-bit fixed point 
operands. 

Floating Multiply 

Performs single or double precision floating point multiplication on 
floating point operands. 

Floating Divide 

Performs single precision floating point division of floating point 
operands. 

Population Count 

Counts the number of 1 bits in a 60-bit word. 

Increment 

Performs one^s complement addition and subtraction of 18-bit operands. 


A functional unit receives one or two operands from operating registers at the beginning of instruction 
execution and delivers the result to the operating registers after performing the function. The functional 
units do not retain any information for reference in subsequent instructions. The units operate in 
three-address mode with source and destination addressing limited to the operating registers. 

Except for the floating multiply and divide units, aU functional units have one clock period segmentation. 
This means that the information arriving at the unit, or moving within the unit, is captured and held in a 
new set of registers at the end of every clock period. It is therefore possible to start a new set of operands 
for unrelated computation into a functional unit each clock period even though the unit may require more 
than one clock period to complete the calculation. This process may be compared to a delay line in which 
data moves through the unit in segments to arrive at the destination in the proper order but at a later 
time. All functional units perform their algorithms in a fixed amount of time. No delays are possible once 
the operands have been delivered to the front of the unit. 

The floating multiply unit has a two clock period segmentation. Operands may enter the multiply unit in 
any clock period providing there was no multiply operation initiated in the preceding clock period. 

The floating divide unit is the only functional unit in which an iterative algorithm is executed. There is 
little segmentation possible in this unit. However, to increase execution speed, the beginning of a new 
divide operation can follow a previous divide operation by 18 clock periods for a gain of 2 clock periods. 

Instructions involving storage references for operands or program branching are difficult to time. Program 
branching within the instruction stack causes no storage references and small program loops can therefore 
be precisely timed. 
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8.2.4 CYBER 180 Model 990 Execution 


Execution of an arithmetic or logical machine instruction takes place in one of eleven functional units in 
the computation section of the CYBER 180 Modd. 990. Each is a specialized unit with algorithms for a 
portion of the CPU instruction execution. Table 8-3 lists the general function of each unit. A number of 
functional units can be in operation at the same time. 


TABLE 8-3. CYBER 180 MODEL 990 FUNCTIONAL UNITS 


Unit 

General Function 

Boolean 

Performs the basic logical operations of transfer, logical 
product, logical sum, and logical difference- It also performs 
the unpack floating point operation. 

Shift 

Performs left (circular) and right (end-off) shifting and mask 
generation. 

Normalize 

Performs the normalize operation. 

Floating Add 

Peforms single or double precision floating point addition or 
subtraction on floating point operands. 

Long Add 

Performs integer addition or subtraction of two 60-bit fixed 
point operands. 

Floating Multiply 

Performs single or double precision floating point multiplication 
on floating point operands. 

Floating Divide 

Performs single precision floating point division of floating 
point operands. 

Population Count 

Count the number of 1 bits in a 60-bit word. 

Compare 

Performs operand comparison for condition branch instructions. 

Increment 

Performs oner's complement addition and subtraction of 18-bit 
operands. 

Address Control 

Performs address manipulation for fetching and storing data 
from/to memory. 
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A functional unit receives one or two operands from operating registo's at the beginning of instruction 
execution and delivers the result to the operating registers after performing the function* The units 
operate in three-address mode with source and destination addressing limited to the operating registers* 

Except for the floating divide, floating point normal! 2 ^, and boolean units, all functional units have one 
dock period segmentation. This means that the information arriving at the unit, or moving within the unit, 
is captured and held in a new set of registers at the end of every dock period* It is therefore possible to 
start a new set of operands for unrelated computation into a functional unit each dock period, even though 
the xinit may require more than one dock period to complete the calculation. This process can be 
compared to a delay line in which data moves through the unit in segments to arrive at the destination in 
the proper order but at a later time. AH functional units perform their algorithms in a fixed amount of 
time. No delays are possible once the operands have been delivered to the front of the unit. 

The floating divide unit has a twenty^seven period segmentation. A new operand may enter the divide unit 
twenty-seven dock periods after a previous operand entered. 

The floating point normalize unit has a two dock period segmentation, unless the Bj register is BO. In that 
case, it has a one dock period segmentation. 

The boolean unit has a one dock period segmentation unless executing an unpack instruction where register 
Bj is not BO. In this case, it has a two dock period segmentation. 

Instructions involving storage references for operands or program branching are difficult to time because 
of memory conflicts and the 990’s predictive branch logic that is based on a previous history for the branch. 
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8.3 OPERATING REGISTERS 

Twenty-four registers minimize memory references for arithmetic operands and results: 


Function 

Identity 

Length 

Number 

Operand Registers 

XO - X7 

CO Bits 

8 

Address Registers 

AO - A7 

18 Bits 

a 

Index Registers 

BO - B7 

18 Bits 

8 


A register is reserved if it is the destination of an instruction that has been initiated but has not been 
completed. A register is free in the clock period (or minor cycle) following the store into it. 


8.3.1 X REGISTERS 

Eight 60-bit X registers in the computation section of the CPU designated XO, XI,.. .,X7 are the principal 
data handling registers for computation. Data flows from these registers to the SCM (CM) and the 
LCM/UEM (not ECS). Data also flows from SCM (CM) and LCM/UEM (not ECS) into these registers. All 
60-bit operands involved in computation must originate and terminate in these registers. 

Operands and results transfer between SCM (CM) and these registers as a result of placing SCM (CM) into 
corresponding address registers. 

On the CYBER 170 Model 176, the CYBER 70 Model 76, and the 7600, the X registers also serve as address 
registers for referencing single words from LCM. On the CYBER 170 Models 810, 815, 825, 830, 835, 840, 
845, 850, 855, 860, 865, 875, and 990, the X registers also serve as address registers for referencing single 
words from UEM. XO is used as the LCM/UEM relative starting address in a block copy operation. 


8.3.2 A REGISTERS 

Eight 18-bit A registers in the computation section of the CPU, designated as AO, Al,,.. ,A7, are 
essentially SCM (CM) operand address registers. With the exception of AO and XO, A registers are 
associated one-for-one with the X registers. Placing a quantity into an address register Al - A5 causes an 
immediate SCM (CM) read'reference to that relative address and sends the SCM (CM) word to the 
corresponding operand register XI - X5. Similarly, placing a value into address register A6 or A7 causes 
the word in the corresponding X6 or X7 operand register to be written into that relative address of SCM 
(CM). 

The AO and XO registers operate independently of each other and have no connection with SCM (CM). AO is 
used as the relative SCM (CM) stEirting address in a block copy operation and for scratch pad or 
interm ediate. res ults. 


8.3.3 B REGISTERS 

Eight 18-bit B registers in the computation section of the CPU designated as BO, Bl,... ,B7 are primarily 
indexing registers for controlling program execution. Program loop counts can be incremented and 
decremented in these registers. 
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ProCTam addresses may be modified on the way to an A register by adding or subtracting B re^ster 
quantities. The B register also holds shift counts for pack and normaUze operations and the channel 
number for channel status requests, 

BO always contains positive zero; that is, BO is held clear. Often as a programming convention, B1 or B7 
contains positive 1. See the Bl=l, the B7=l, and the R= pseudo instructions. 


8.4 SYMBOLIC NOTATION 

This section describes notation used for coding symbolic CPU machine instructions. Instructions are listed 
in groups according to function. Instructions unique to a computer system are identified as such in 
table 8-4. These instructions can be assembled on any machine but will execute properly on the noted 
machine only. Table 8-5 lists the functional unit, if any, in which each instruction executes. For details 
and special conditions arising during instruction execution, refer to the relevant hardware system reference 
manual. 


TA.BLE 8-4, CPU INSTRUCTION/MACHINE MODEL CORRESPONDENCE 



Machine Model Number 


Mneinonic 

Code 

810, 815, 825, 830, 

835, 840, 845, 850, 855, 
860, 865, 875, and 990 

76 and 7600 

171, 172, 173, 174, 175, 

720, 730, 740, 750, and 760; 
71, 72, 73, and 74; and 

6000 Series 

176 

AXi 

X 

X 

X 

X 

BXi 

X 

X 

X 

X 

cct 





CR 

X 




cut 





cw 

X 




CXi 

X 

X 

X 

X 

DF 

X 

X 

X 

X 

DMt 





DXi 

X 

X 

X 

X 

EQ 

X 

X 

X 

X 

ES 


X 



FXi 

X 

I 

X 

X 

X 

GE 

X 

X 

X 

X 

GT 

X 

X 

X 

X 

IBj 


X 


X 

ID 

X 

X 

X 

X 

IMt 





IR 

X 

X 

X 

X 

IXi 

X 

X 

X 

X 

JP 

X 

X 

X 

X 

LE 

X 

X 

X 

X 

LT 

X 

X 

X 

X 

LXi 

X 

X 

X 

X 
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TABLE 8-4• CPU INSTRUCTION/MACHINE MODEL CORRESPONDENCE (Contd) 


Mnemonic 

Code 



TcMU instruction: Compare/Move Unit available on CYBER 170 Models 172, 173, 174, 

720, and 730. Models 810, 815, 825, 830, 835, 840, 845, 850, 855, 860, and 990 support 
CMU instructions through simulation. 
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TABLE 8--5. CPU INSTRUCTION/FUNCTIONAL UNIT CORRESPONDENCE 


Mnemonic 

Operation 

Code 

Functional Unit 

74, 6600, 
and 6700 

175, 176, 740, 

750, and 760; 

76; and 7600 

990 

AXi 


Shift 

Shift 

Shift 

BXi 


Boolean 

Boolean 

Boolean 

CR 


None 

None 

None 

CW 


None 

None 

None 

CXi 


Divide 

Pop 

Pop 

DF 


Branch 

None 

None 

DXi 

32ijk 

FP Add 

FP Add 

FP Add 

DXi 

33ijk 

FP Add 

FP Add 

FP Add 

DXi 

42ijk 

Multiply 

Multiply 

Multiply 

EQ 


Branch 

None 

Compare 

ES 


t 

None 

None 

FXi 

30ijk 

FP Add 

FP Add 

FP Add 

FXi 

31ijk 

FP Add 

FP Add 

FP Add 

FXi 

AOijk 

Multiply 

Multiply 

Multiply 

FXi 

44ijk 

Divide 

Divide 

Divide 

GE 


Branch 

None 

Compare 

GT 


Branch 

None 

None 

IBj 


t 

None 

None 

ID 


Branch 

None 

None 

IR 


Branch 

None 

None 

IXi 

36ijk 

Long Add 

Long Add 

Long Add 

IXi 

37ijk 

Long Add 

Long Add 

Long Add 

IXi 

42ijk 

Multiply 

Multiply 

Multiply 

JP 


Branch 

None 

None 

LE 


Branch 

None 

Compare 

LT 


Branch | 

None 

Compare 

LXi 


Shift i 

Shift 

Shift 

MI 


Branch 

None 

None 

MJ 


t 

None 

None 

MXi 


Shift 

Shift 

Shift 

NE 


Branch 

None 

Compare 

NG 


Branch 

None 

Compare 

NO 


None 

None 

None 

NXi 


Shift 

Normalize 

Normalize 

NZ 


Branch 

None 

Compare 

OBj 


t 

None 

None 

OR 


Branch 

None 

None 

PL 


Branch 

None 

None 

PS 


Branch 

t 

t 

PXi 


Shift 

Boolean 

Boolean 
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TABLE 8-5. CPU INSTRUCTION/FUNCTIONAL UNIT CORRESPONDENCE (Contd) 




Functional Unit 

Mnemonic 

Operation 

Code 

74, 6600, 
and 6700 

175, 176, 740, 

750, and 760; 

76; and 7600 

990 

RE 


Branch 

t 

t 

RI 


t 

None 

None 

RJ 


Branch 

None 

None 

RL 


t 

None 

None 

RO 


t 

None 

None 

RXi 

34ijk 

FP Add 

FP Add 

FP Add 

RXi 

35ijk 

FP Add 

FP Add 

FP Add 

RXi 

Alijk 

Multiply 

Multiply 

Multiply 

RXi 

45ijk 

Divide 

Divide 

Divide 

RXj 

014jk 

t 

None 

None 

SAi 


Increment 

Increment 

Increment and 
Address Control 

SBi 


Increment 

Increment 

Increment and 
Address Control 

SXi 


Increment 

Increment 

Increment and 
Address Control 

TBj 


t 

None 


UXl 


Shift 

Boolean 


WE 


Branch 

None 


WL 


t 

None 

None 

WXj 

015jk 

t 

None 

None 

XJ 

01300 

None 

None 

None 

XJ 

013jk 

Branch 

t 

t 

ZR 


Branch 

None 

Compare 

ZXi 


Shift 

Normalize 

Normalize 

tinstruction not supported for this model. 


The location field of a symbolic machine instruction optionally contains a location symbol. When the 
symbol is present, it is assigned the value of the location counter after the force upper (if any) occurs. 


The operation field of a symbolic CPU machine instruction contains a mnemonic operator, the last two 
characters of which are often a register designator. 

The variable field contains one, two, or three subfields. For 15-bit instructions, subfields take the forms: 


r 

-r 
r,r 

r op r ) 
-r op r / 


r is a register designator 


op is are^ster operator + - * / 


jk jk is an absolute expression specifying a shift count or mask bit count. If the 

expression value is in the range -60 to -0, inclusive, COMPASS adds 60 to it. If 
it is less than -60 or greater than 63, COMPASS sets a warning flag and uses the 
low-order 6 bits of the expression v^ue. 
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For a 30-bit instruction, subfields take the forms: 


K 

The single subfield contains an absolute, relocatable, or external expression 
that does not include a register. 

r op K 

The single subfield contains an absolute, relocatable, or external expression 
that includes a register designator; op is an expression operator: 



r,K 

One subfield contains a register designator, the other subfield contains an 
absolute, relocatable, or external expression that does not include a register 


designator. 

r,r,K 

Two subfields contain register designators; a third contains an absolute, 
relocatable, or external expression that does not include a register. 


In the formats and examples, K reduces to an 18-bit value that represents one of the following in pass two: 
An absolute address or a word count 
An external symbol + an integer value 

An address that is relocatable relative to the program origin or common block origin. 

An address of a literal 

If K is negative, the assembler inserts the one^s complement of the integer value in the K portion of the 
instruction. 

In the descriptions of the formats, + K designates that the evaluation of all nonregister elements can result 
in a positive or negative value for the expression (see Evaluation of Expressions in chapter 2). Use of + K 
to represent the integer portion of the expression does not imply that the first term operator in the 
expression is an expression operator. If you consider that a and b are terms in expression K, then +K 
indicates that the sum of the values of a and b is positive and -K indicates that the sum of the values is 
negative. Thus, -K does not mean that a-b would become -a+b. 

In the following example, the symbol XRAY has the value 407g. The first term operator (-) forms the 
value 777370g. Subtracting 1 from this results in 777367g or a-K (-410g). 


Code Generated 


7212777367 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


n 

IB 

ho 



SXl 

X2-XRAY-1 1 

1 


Unless otherwise noted, subfields can be in any order. COMPASS also allows an added degree of flexibility 
by allowing the variable subfields of an instruction to be written in the operation field with each subfield 
preceded by a comma. For example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


11 

IB 

ho 

26123 



UX1 

B2,X3 1 
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can be written 


Code Generated 


LOCATJON 

OPERATION 

VARIABU 

COMMENTS 


1 


t) 

IS 

I 30 

26123 



UX1,B2 

Ix3 


The instructions are identical to the assemble*. 


Similarly, the following instructions are regarded as identical. Use of this feature is optional. 




LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


11 

IB 

ho 

04230106^1 



EQ 

B2,B3,K 

1 ... 

1 

0423010641 



EQ,B2 

B3,K 

1 

0423010641 



EQ,B2,B3 K 


0423010641- 



EQ,B2,I 

53,K 

1 

1 

1 

1 


8.4.1 PROGRAM STOP OR EXCHANGE JUMP INSTRUCTION 

The CEJ/MEJ Panel Switch determines whether this instruction causes the central processor unit to halt or 
to execute an exchange jump. The DISABLE position disables the central exchange jump or the monitor 
exchange jump. In this ease, the instruction is illegal for a CYBER 170 Model 175. For all other systems, 
PS halts the central processor unit at the current step in the program. An exchange jump is necessary to 
restart the central processor unit. The ENABLE petition enables the jump capabilities for all systems. In 
this case, PS causes an exchange jump to monitor address (MA) in the exchange package. For the CYBER 
180 Computer Systems and the CYBER 170 Models 176, 815, 825, 835, 845, 855, 865, and 875 exchange 
jumps are always enabled. For 6000 series systems, the CRJ/MEJ switch is ignored; PS always causes the 
central processor unit to halt. The job continues to hold a control point until the time limit is satisfied; at 
that time the job aborts. 

The contents of the location field become a sub-subtitle on the assembler listing. The assembler forces 
upper before and after assembling a PS instruction. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

PS 


Program stop or exchange jimip to (MA) 

30 bits 

00000 00000 

PS 

K 

Program stop or exchange jump to (MA) 

30 bits 

OOOOK 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


11 

IB 

|30 





1 - 

0000000000 



PS 

t 

1 
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8.4.2 ERROR EXIT INSTRUCTION 


ES execution is treated as an error condition and the machine sets the program range condition flag in the 
PSD register. The condition flag then generates an error exit request which causes an exchange jump to 
address (EEA). All instructions issued prior to this instruction are run to completion. Any instruction 
following this instruction in the current instruction word is not executed. When all operands have arrived 
at the operating registers as a result of previously issued instructions, an exchange jump occurs to the 
exchange package designated by (EEA). 

The i, j, and k designators, which are ignored by the computation section, are set to zero by the assembler. 
The program address stored in the exchange package on the terminating exchange jump is advanced one 
count from the address of the current instruction word (P=P+1). This is true regardless of which parcel of 
the current instruction word contains the error exit instruction. 

The error exit instruction is not intended for use in user program code. The program range condition flag is 
set in the PSD register to indicate that the program has jumped to an area of the SCM field which may be 
in range but is not valid program code. This should occur when an incorrectly coded program jumps into an 
unused area of the SCM field or into a data field. The program range condition flag is also set on the 
condition of a jump to address zero. These conditions can be determined on the basis of the register 
contents in the exchange package. The existence of an error exit condition resulting from execution of this 
instruction can thus be deduced. 

The location field of an ES instruction becomes a sub-subtitle on the assembler listing. 

A force upper occurs after the ES instruction. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

ES 


Error exit to EEA 

15 bits 


ES 

K 

Error exit to EEA 

15 bits 

00000 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 




n 

ie 

ho 

OOCOO 



c 

-1- 

1 

1 


8.4.3 RETURN JUMP INSTRUCTION 

When this instruction is executed, an unconditional jump to the current address plus one (P}+1 is stored in 
the upper half of relative address K in SCM and control then transfers to K+1 for the next instruction. The 
lower half of the stored word is all zeros. The instruction always branches out of the instruction stack and 
voids all instructions currently in the instruction stack. 

After the instruction is executed the octal word at K is: 


Address K 


0 4 0 0 


P 4- 1 


0000000000 


59 


29 


00 


Bi=Bj 
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This instruction is intended for transferring control to a subroutine between execution of the current 
instruction word and the following instruction word. Instructions appearing after the return jump 
instruction in the current instruction are not executed. The called subroutine must exit at address K in CM 
(SCM). A jump to address K of the branch routine returns the program to the original sequence. The 
assembler sets the unused j designator to zero. 

A force upper occurs after the instruction is assembled. 

Format; 


Operation 

Variable 

Description 

Size 

Octal Code 

RJ 

K 

Return jump to K 

30 bits 

0100 K 


Example: 


Code Generated 


lOCATION 

OPERATION 

VARIABLE COMMENTS 

010000237^1 + 

1 


11 

IB ho 



RJ 

HELP ! 


8.4.4 ECS/UEM INSTRUCTIONS 

These instructions initiate either a read or write operation to transfer (Bj)+K 60~bit words between 
extended memory (ECS or UEM) and central memory (CM). The initial extended memory address is 
(XO)+RAe 5 the initial CM address is (AO)+RAq. 


NOTE 

For the CYBER 180 Computer Systems and the CYBER 170 Models 815, 825, 835, 

845, and 855, these instructions are UEM block copy instructions. For the CYBER 
170 Models 865 and 875, the selection of the ECS or UEM depends on the state of 
the UEM enable flag. This flag is one bit in the 6-bit flag register in the exchange 
sequence. If the enable flag is set, transfer is between UEM and CM; if the enable 
flag is dear, transfer is between ECS and CM. 

The assembler forces upper before assembling an RE or WE instruction. 

If no error occurs, the next instruction executed is the first instruction in the current address plus one 

(P)+1. 

Three error conditions cause an error exit to the lower-order 30 bits of the instruction word containing the 
RE or WE instructions. These 30 bits should always hold a jump to an error routine. The conditions are: 

Parity errors when reading ECS. If a parity error is detected, the entire block of data is transferred 
before the exit is taken. 

The ECS bank from/to which data is to be transferred is not available because the bank is in 
maintenance mode, or the bank has lost power. If either of these conditions exists on an attempted 
read or write, an immediate error exit is taken. 

An attempt to reference a nonexistent address. On an attempted write operation, no data transfer 
occurs and an immediate error exit is taken- If the attempted operation is a read, and addresses are in 
range, zeros are transferred to central memory. This is a convenient high-speed method of clearing 
blocks of central memory. 
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On a CYBER 170 Model 176, action in the case of error depends on the operating system being run. Under 
SCOPE 2, error processing is just as for the RL and WL instructions (see LCM Block Copy Instructions). 
Under NOS, on error causes the job to abort. Under NOS/BE, an error exit to the lower 30 bits of the 
instruction word takes place. This action is provided by the operating system, not by the hardware. 

For additional information about ECS instructions, refer to the 7030 Extended Core Storage Reference 
Manual. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

RE 

Bj 

Read extended memory 

30 bits 

OlljO 00000 

RE 

K 

Read extended memory 

30 bits 

OllOK 

RE 

Bj+K 

Read extended memory 

30 bits 

OlljK 

WE 

Bj 

Write extended memory 

30 bits 

012j0 00000 

WE 

K 

Write extended memory 

30 bits 

0120K 

WE 

Bj+K 

Write extended memory 

30 bits 

012jK 


Example: 

Code Generated 

0110002000 
0117001000 
0125001000 



iOCATlON 

OPERATION 

VARIABLE 

COMMENTS 

I 


11 

18 

ho 







RE 

2000B 

1 

i 



RE 

B7+1000B 

1 

1 



WE 

1000B+B5 

1 

1 


8.4.5 LCM BLOCK COPY INSTRUCTIONS 

Block copy instructions move quantities of data between LCM and SCM as quickly as possible. All activity 
in the CPU other than I/O word requests is stopped during a block copy operation. All instructions issued 
prior to a block copy instruction are executed to completion and no further instructions issue until the 
block copy is nearly completed. As a result of these restrictions the data flow between LCM and SCM can 
proceed at the rate of one 60-bit word each clock period. When an I/O multiplexer word request for SCM 
occurs during this transfer, the data flow is interrupted for one clock period. The I/O word address is 
inserted in the stream of addresses to the SAS, and the addresses for the block copy are resumed with a 
minimum of a one clock period delay. An additional delay will occur if the I/O reference causes a bank 
conflict in SCM. 

The length of the block is determined by adding the quantity K to the contents of register Bj. Either 
quantity may be used as an increment or decrement. The result is an 18-bit integer which is truncated to a 
10-bit quantity. Thus, a maximum block size is 17773. example, if the result of the add is 
OOSOOOg, the instruction transfers 1000g words.) No error indications are given when this occurs unless 
the field length is exceeded causing a block range error. If the block length is zero, the instruction 
becomes a do-nothing instruction; the condition is not error flagged. 

Relative source or destination addresses begin at (AO) in the SCM and at the relative LCM address 
determined from the lowest order 19 bits of (XO). If (XO) is negative, the 19 bits are treated as a positive 
integer. If the sum of (XO^a-oo) block count exceeds the (FLL), the copy is not executed and the 
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LCM block range condition flag is set in the PSD register. Similarly, if the sum of (AO) and the block 
exceeds (FLS), the copy is not executed and the SCM block range condition flag is set in the PSD register. 

Under SCOPE 2, COMPASS will truncate a block copy instruction if it begins in the last parcel and its 
K field is zero. Under such conditions, a block copy is a 15--bit instruction. 

Under NOS and NOS/BE, COMPASS forces upper after assembling an RL or WL instruction. 

Any error condition occurring during execution of a block copy instruction causes a flag to be set in the 
PSD register but does not interrupt the block copy instruction. No further instructions are issued during 
block transfer of data. Instructions already issued are completed; all other activity, with the exception of 
I/O word requests, stops. 

On a CYBER 170 Model 176, if no error takes place, the next instruction executed is the first instruction 
in the current address plus one (P) + l . Action in the case of error depends on the operating system being 
run. Under SCOPE 2, error processing is just as for any program running on the CYBER 70 Model 76, as 
described in the SCOPE 2 Reference Manual listed in the preface. Under NOS, an error causes the job to 
abort. Under NOS/BE, an error exit to the lower 30 bits of the instruction word takes place. This action is 
provided by the operating system, not by the hardware. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

RL 

Bj 

Block copy (Bj) words from LCM to SCIM 

30 bits? 

OlljO 00000 

RL 

K 

Block copy (K) words from LCM to SCI^I 

30 bits 

Oil OK 

RL 

Bj+K 

Block copy (Bj) + K words from LCM to 





SCM 

30 bits 

OlljK 

WL 

K 

Block copy (K) words from SCM to LCM 

30 bits 

0120K 

WL 

Bj 

Block copy (Bj) words from SCM to LCM 

30 bits 

012j0 00000 

WL 

Bj+K 

Block copy (Bj) + K words from SCM to 





LCM 

30 bits 

012jK 


Example; 

Code Generated 

01 15001000 
0110002000 
012^1777677 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

j 


II 

IB 

|30 







RL 

1000B+B5 

1 



RL 

2000B 

1 

1 

j 


WL 

B4-100B 

1 

j 


8.4.6 EXCHANGE JUMP INSTRUCTION 

This instruction unconditionally exchange jumps the central processor, regardless of the state of the 
monitor flag bit. Instruction action differs, however, depending on whether the monitor flag bit is set or 
clear. 

This instruction is not legal for CYBER 170 Models 175, 740, 750, and 760 if the MEJ/CEJ switch is in the 
DISABLE position or if the instruction does not reside in parcel 0 of the instruction word. 
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Operation is as follows; 

Monitor flag bit elear: The starting address for the exchange is taken from the 18-bit Monitor Address 
register. This starting address is an absolute address. During the exchange, the monitor flag bit is set. 

Monitor flag bit set; The starting address for the exchange is the 18-bit result formed by adding K to 
the contents of register Bj. This starting address is an absolute address. During the exchange, the 
monitor flag bit is cleared. 


For additional information, refer to the appropriate hardware reference manual. 
The assembler forces upper before and after assembling an XJ instruction. 
Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

XJ 


Exchange jump to MA if in program mode 

30 bits 

01300 00000 

XJ 

Bj 

Exchange jump to (Bj); flag set 

30 bits 

013j0 00000 

XJ 

K 

Exchange jump to K; flag set 

30 bits 

0130K 

XJ 

Bj+K 

Exchange jump to (Bj) ± K; flag set 

30 bits 

013jK 


Example: 

Code Generated 

0130000000 

0130001000 

0135000600 



8.4.7 EXCHANGE EXIT INSTRUCTION 

This instruction is used for calling a system monitor program for input/output, monitor calls, etc. and has 
priority over all other types of exchange jump requests. If an I/O interrupt request or an error exit request 
occurred prior to execution of this instruction, it is denied and the exchange jump specified by the MJ is 
executed. The rejected interrupt request is not lost, however. The conditions that caused it are reinstated 
when the exchange package enters its next execution interval. 

The normal termination for an exchange package execution interval is through execution of an exchange 
instruction (MJ). The MJ instruction voids the Instruction word stack. Any instructions remaining in the 
stack are not executed. The exit mode flag in the PSD register determines the source of the exchange 
package as follows: 

Exit mode flag set: When the exit mode flag is set, the MJ instruction causes the current program 
sequence to terminate with an exchange jump to a relative address in the SCM field for the current 
program. The exchange package is located at relative address (Bj) +K. An overflow of the lowest 
order 16 bits of this result causes an error condition that is not sensed in the hardware. Should a 
program erroneously execute an exchange exit instruction with an overflow condition, the exchange 
jump sequence begins at the absolute SCM address corresponding to the lowest order 16 bits of this 
sum. This 30-bit form of MJ is privileged to a monitor program. 


8-18 


60492600 H 







Exit mode flag not set: When the exit mode flag is not set, the object program terminates the 
execution interval with a 15-bit form of the MJ instruction. The normal exit address (NEA) is the 
absolute address of the exchange package. This is an absolute address in SCM and is generally not in 
the SCM field for the current program. This form of the MJ instruction has a blank variable field; the 
assembler sets the j and k designators to zero. 

The system makes no protective tests on the exchange jump address. 

All operating register values, program addresses, and mode selections are preserved in the exchange 
package for the object program so that the object program can be continued at a later time. The program 
address in the object program exchange package is advanced one count from the address of the instruction 
word containing the exchange exit instruction. The monitor program normally resumes the object program 
at this address. 

The assignment of (NEA) is a responsibility of the system monitor program. If (NEA) has more thsui 16 bits 
of significance, the upper bits are discarded and the lower 16 bits are used as the absolute address in SCM 
for the exchange jump. A force upper occurs after the instruction is assembled. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

MJ 


Exchange exit to NEA if exit flag clear 

15 bits 

01300 

MJ 

Bj 

Exchange exit to (Bj) if exit flag set 

30 bits 

013j0 00000 

MJ 

Bj+K 

Exchange exit to (Bj) + K if exit flag set 

30 bits 

013jK 

MJ 

K 

Exchange exit to K if exit flag set 

30 bits 

0130K 


Example: 

Code Generated 

01300 

013^000500 

0136777^77 

0130000600 



8.4.8 DIRECT LCM TRANSFER INSTRUCTIONS 

A single word transfer either reads one 60-bit word from LCM and enters this word into an X register or 
writes one 60-bit word directly into LCM from an X register. 

The execution time for transferring a word from LCM to an X register depends on whether the requested 
word already resides in one of the bank operand registers. A read LCM instruction for a word not currently 
residing in a bank operand register will require 17 clock periods for delivering a field of eight 60-bit words 
to the designated X register. A read LCM instruction for a word already residing in an LCM bank operand 
register as a result of a previous instruction will require three clock periods to deliver the requested word 
to the designated X register. Thus, although the first 60-bit word will require 17 clock periods, the second 
through eighth words in the same LCM word require three clock periods each. This means that consecutive 
LCM operands are available, on an average, every five clock periods as opposed to SCM operands at eight 
clock periods. 
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The LCM address is determined from the low order 19 bits of Xk. Even if (Xk) is negative, the 19 bits are 
treated as a positive integer. If the address exceeds the field length (FLL), the word transfer does not take 
place and the LCM direct range condition flag is set in the PSD register, Xj is either the source or 
destination register. 

Instructions are buffered to the extent that each issues in one minor cycle unless a previous LCM reference 
is in process. When an RX instruction issues, the LCM busy Gag is set and remains set until the requested 
word is delivered. 

For a write (WX) instruction, if the word cannot be entered immediately in the proper bank operand 
register, it is held in the LCM write register until the bank operand register is free. 

Format; 


Operation 

Variable 

Description 

Size 

Octal Code 

RXj 

Xlv 

Read LCM al (Xlv) and set Xj 

15 bits 

014jlv 

WXj 

Xlv 

Write (Xj) Into LCM at (Xli) 

15 bits 

015jk 


Example; 

Code Generated 

011)65 

01570 



lOCATlON 

OPERATION 

VARIABLE 

COMMENTS 

1: 


M 

IB 

ho 







RX6 

X5 

1 

1 



WX7 

xo 

1 

1 


8.4.9 DIRECT UEM TRANSFER INSTRUCTIONS 

A single word transfer either reads one 60-bit word from UEM and enters that word into the specified X 
register, or writes one word into UEM from the specified X register. 

Format: 


Operation 

V ariable 

Description 

Size 

Octal Code 

RXj 

Xk 

Read UEM at (Xk) + RAg to Xj 

15 bits 

014jk 

WXj 

Xk 

Write (Xj) to UEM at (Xk) + RAg 

15 bits 

015jk 


Example: 




LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

Code Generated 

1 


11 

18 

30 

01A12 



RX1 

X2 


01512 



WX1 

X2 
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8.4.10 RESET INPUT CHANNEL BUFFER INSTRUCTION 


This instruction initiates a new record transmission from a PPU to SCM. This instruction prepares the 
input channel (Bk) buffer for a new record transmission from a PPU to SCM. The instruction clears the 
input channel buffer address and resets the input channel assembly counter to the first 12-bit position in 
the SCM word. 

This instruction is intended to be privileged to an input routine, that is, one that terminates a record of 
incoming data and prepares for the next record. 

The input routine removes the data in the input channel buffer and then executes this instruction to 
prepare the buffer for the next incoming record. This instruction is effective only if the monitor mode flag 
is set in the program status register. If the monitor mode flag is cleared, this instruction becomes a pass 
instruction. When this instruction issues, it will execute the required channel functions without regard to 
the current status or activity at the input channel buffer. 

The lowest order four bits of (BIc) are used in this instruction. The higher order bits are ignored. If higher 
order bits are set in (Bk) the lowest order four bits are masked out and used to determine the channel 
number. If (Bk) is zero, this instruction becomes a pass instruction. 

Two or more consecutive RI instructions referring to different channels will issue in consecutive clock 
periods with no interference resulting in the multiplexer. If two consecutive instructions refer to the same 
channel, they repeatedly perform the same function but do not cause interference in the multiplexer. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

RI 

Bk 1 

Reset input channel (Bk) buffer 


OlGOk 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


li 

IB 

l30 





I . 

01607 



RI 

B7 1 


8.4.11 SET REAL-TIME CLOCK INSTRUCTION 

This instruction reads the contents of the CPU clock period counter (real-time clock) and places them 
in Bj. The 18-bit clock counter advances one count in two^s complement mode for each clock period. The 
217 is the overflow bit. The CPU is interrupted when the overflow bit is set. When the interrupt is 
handled, the bit is cleared. It permits measurement of CPU execution. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

TBj 


Set Bj to current clock time 

15 bits 

OlGjO 

TBj 

K 

Set Bj to current clock time; K is ignored. 

15 bits 

OlGjO 
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Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


I 


11 

IB 

Uq 

01670 



TB7 

1-j--- 


8,4.12 RESET OUTPUT CHANNEL BUFFER INSTRUCTION 

This instruction initiates a new record transmission from SCM to PPU. It clears the output channel (Bk) 
buffer address and disassembly counter, transmits a record pulse over the output channel data path to the 
PPU, and initiates an SCM reference for the first word to be transmitted. 

This instruction is intended for execution in an output routine to initiate a new record transmission over an 
output channel data path. The output channel buffer is normally inactive when this instruction is 
executed. The output channel buffer is loaded with the data for the next record, and this instruction is 
executed to initiate the transmission. The record pulse is transmitted along with the word pulse as soon as 
the first word of data from the SCM is entered in the output channel disassembly register. 

This instruction is effective only if the monitor mode flag is set in the program status register. If the 
monitor mode flag is cleared, this instruction becomes a pass instruction. When this instruction issues, it 
will execute the required channel functions without regard to the current status or activity at the output 
channel. 

The lowest order four bits of (Bk) are used in this instruction. The higher order bits are ignored. If higher 
order bits are set in (Bk), the lowest order four bits are masked out and used to determine the channel 
number. If (Bk) is zero, this instruction becomes a pass instruction. 

Normally, the output channel buffer is inactive when this instruction is executed, the program having 
checked for completion of the previous record before issuing an RO. The program can detect the end of 
record in two ways. First, it can compare the output channel buffer address with a known record length. 
The alternative is to obtain a response from the peripheral unit over the corresponding input channel data 
path. If data is moving over the output channel data path when an RO is issued, the RO instruction takes 
priority, with a resulting loss of data in the previous record. Two or more consecutive RO instructions 
referring to different channels will issue in consecutive clock periods with no interference resulting in the 
multiplexer. If two consecutive instructions refer to the same channel, they transmit a record pulse over 
the output path and restart the buffer repeatedly. A data word may or may not be transmitted depending 
on the timing of the instructions and conflicts that occur. 

Format: 


Operation 

Variable 

Description 

Si ze 

Octal Code 

RO 

Bk 

Reset outi^ut channel (Bk) buffer 

15 bits 

0170k 


Example: 

Code Generated 


01705 



LOCATION 

OPERATION 

variable 

comments 

1 


M 

IB 

l30 




J- 



RO 

B5 ■ 


8.4.13 READ CHANNEL STATUS INSTRUCTIONS 

These instructions copy the contents of the input or output channel buffer address register indicated by 
masking the low order 4 bits of Bk and enter the value in Bj. The instructions are used for monitoring the 
progress of an input channel buffer or an output channel buffer. 
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A channel buffer area is divided into fields by the threshold testing mechanism. The first half of the buffer 
area constitutes one field and the last half of the buffer area the other field. An I/O multiplexer interrupt 
request is generated by the threshold testing mechanism whenever the channel buffer address is advanced 
across a field boundary. This occurs at the center of the buffer area and at the end of the buffer area. 

The IBj instruction is the only vehicle for a program to determine whether an I/O multiplexer interrupt 
request was generated by a buffer threshold test or by a record flag. The program must retain the input 
channel buffer address from one interrupt period to the next. If the buffer address is in the same field as 
for the previous interrupt, the interrupt request was from a record flag. If the buffer address is in the 
opposite field from the previous interrupt, the interrupt request was from a threshold test. 

The lowest order four bits of (Bk) are used in these instructions. The higher order bits are ignored. If 
higher order bits are set in (Bk) the lowest order four bits are masked out and used to determine the 
channel number. If (Bk) = 0, the IBj instruction reads the contents of the CPU clock period counter. 
However, the OBj instruction places all zeros into Bj. 

Two or more IBj instructions or OBj instructions may occur in consecutive program instruction locations 
referencing the same or different channels. These instructions may issue in consecutive clock periods 
providing the Bj register reservations do not cause a delay. No interference will result in the multiplexer 
in these situations. 

If correct results are to be obtained, an IBj instruction must not immediately follow an RI instruction nor 
may an OBj instruction immediately follow an RO instruction. A delay of one clock period is sufficient. 

Format: 


Operation 

Variable 

Description 

Si zc 

Octal Code 

IBj 

Bk 

Bj *^Read input channel (Bk) status 

15 bits 

OlCjk 

OBj 

Bk 

Bj —Read output channel (Bk) status 

10 bits 

017jk 


Example: 


Code Generated 


lOCATION 

OPERATION 

VARIABLE 

COMMENTS 


\ 


ir 

IB 

ho 

016611 



IB6 

B4 

-j--- 

1 

J 

01756 



OB5 1 

B6 

1 

1 


8.4.14 UNCONDITIONAL JUMP INSTRUCTION 

This instruction adds the contents of index register Bi to K and branches to the relative CM (SCM) address 
specified by the sum. The remaining instructions, if any, in the current instruction word are not executed. 
The branch address is K when i is zero. 

Addition is performed in an 18-bit one^s complement mode. On the CYBER 180 Series, the CYBER 170 
Series (except Model 176), the CYBER 70 Models 71, 72, 73, and 74, and 6000 Series systems, this 
instruction voids the stack. On the CYBER 70 Model 76. the 7600, and the CYBER 170 Model 176, the 
instruction word stack is not altered by execution of this instruction. The instruction is intended to allow 
computed branch point destinations. It is the only CPU instruction in which a computed parameter can 
specify a program branch destination address. All other jump instructions have preassigned destination 
addresses at execution time. 

The assembler sets the unused j designator to the same value as the i designator. A force upper occurs 
after the instruction is assembled. 
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Format: 


Operation 

Variable 

Description 

— 

Size 

Octal Code 

JP 

Bii-K 

Jump to (Bi)d:K 

30 bits 

02iiK 

JP 

Bi 

Jump to (Bi) 

30 biLs 

02ii0 00000 

JP 

K 

Jump to K 

30 bits 

0200K 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE COMMENTS 

0255002373 + 

0277000000 

1 


U 

IB [30 



JP 

JP 

B5+GOTO 1 

1 

B7 1 


8.4.15 X-REGISTER CONDITIONAL BRANCH INSTRUCTIONS 

These instructions cause the program sequence to branch to K or to continue with the current program 
sequence depending on the contents of operand register Xj, The decision is not made until the Xj register 
is free. These instructions do not void the stack. 

The following rules apply to tests made in this instruction group: 

The ZR and NZ operations test the full 60-bit word in Xj. The words 00.00 and 77. 773 are 

treated as zero. AU other words are non-zero. Thus, these instructions are not a valid test for 
floating point zero coefficients. However, they can be used for underflow of floating point quantities. 

The PL and NG operations examine only the sign bit (bit 59) of Xj. If the sign bit is zero, the word is 
positive; if the sign bit is one, the word is negative. Thus, the sign test is valid for fixed point words 
or for coefficients in floating point words. 

The IR and OR operations examine the upper-order 12 bits of Xj. 

On the CYBER 170 Model 176, the CYBER 70 Model 76, and the 7600, the following octal quantities 
are detected as being out of range: 

3777x.x (positive overflow) 

4000x.x (negative overflow) 

1777x. X (positive indefinite) 

6000x.X (negative indefinite) 

All other words are in range. An underflow quantity is considered in range. The value of the 
coefficient is ignored in making this test. 

On CYBER 70 Models 71, 72, 73, and 74; CYBER 180 Series; CYBER 170 Series (except Model 176); 
and 6000 Series computer systems, the octal quantities 3777x.. .x and 4000x. - .x are out of range; all 
other words are in range. 

The DF and ID operations examine the upper-order 12 bits of Xj. Both positive and negative indefinite 
forms are detected: 

1777x.X and 6000x.x are indefinite. 

AU other words are definite. The value of the coefficient is ignored in making this test. 
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An error exit occurs on 6000 Series; CYBER 180 Series; CYBER 170 Series; and CYBER 70 Models 71, | 

72, 73 and 74 systems when an indehnite or out of range value is used as an operand of an arithmetic 
instruction* Such error exits can be avoided by uang DF, ID, IR, or OR instructions to test for such 
values before using them as operands. 

On a 7600 or CYBER 70 Model 76 system, an error exit occurs as soon as an indefinite or out of range 
value is produced as the result of an arithmetic instruction. The DF, ID, IR and OR instructions are 
useful only when a MODE control statement is used to suppress such error exits. 


Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

ZR 

Xj.K 

Branch to K if (Xj) ~ 0 

30 bits 

030jK 

NZ 

Xj.K 

Branch to K if (Xj) / 0 

30 bits 

031jK 

PL 

Xj.K 

Branch to K if (Xj) sign is plus 

30 bits 

032jK 

NG 

Xj.K 

Branch to K if (Xj) sign is minus 

30 bits 

o 

CO 

MI 

Xj.K 

Branch to K if (Xj) sign is minus 

30 bits 

033jK 

IR 

Xj.K 

Branch to K if (Xj) in range 

30 bits 

034jK 

OR 

Xj.K 

Branch to K if (Xj) out of range 

30 bits 

035jK 

DF 

Xj.K 

Branch to K if (Xj) definite 

30 bits 

03GjK 

ID 

Xj.K 

Branch to K if (Xj) indefinite 

30 bits 

037jK 


Example: 


Code Generated 


LOCATJON 

OPERATION 

VARIABLE COMMENTS 


\ 


11 

IB |3Q 

0305002363 + 



ZR 

X5.ZER0 [ 

0313002364 + 



NZ 

X3,NONZERO 1 

1 

0324002365 + 



PL 

X4,PLUS 1 

0331002366 + 



NG 

X1,NEG j 

0331002366 + 



MI 

X1,NEG ! 

0340002367 + 



IR 

1 

XO,INRANGE ^ 

1 

0351002370 + 



OR 

X1,0UTRNGE ' 

0365002371 + 



DF 

X5,DEFINT 1 

0377002372 + 



ID 

X7,INDEFNT I 
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8.4.16 B-REGISTER CONDITIONAL BRANCH INSTRUCTIONS 

The following rules apply in the tests made by these instructions: 

Positive zero is recognized as unequal to negative zero. 

Positive zero is recognized as greater than negative zero. 

A positive number is recognized as greater than a negative number- 

The 06 and 07 instructions are intended for branching on an index threshold test. The tests are made in a 
19-bit one»s complement mode. The (Bi) and the (Bj) are sign extended one bit to prevent erroneous results 
caused by exceeding the modulus of the comparison device. The (Bj) is then subtracted from the (Bi). The 
branch decision is based on the sign bit in the 19-bit result. 

For these instructions, Bi and Bj must be specified in the order indicated below. 

These instructions do not void the instruction stack. 

Format: 


Operation 

Variable 

Description 

Si ze 

Octal Code 

ZR 

K 

Branch to K 

30 bits 

0400K 

ZR 

Bi,K 

Branch to K if (Bi) = 0 

30 bits 

04iOK 

EQ 

K 

Branch to K 

30 bits 

0400K 

EQ 

Bi,K 

Branch to K if (Bi) = 0 

30 bits 

04i0K 

EQ 

Bi,Bj,K 

Branch to K if (Bi) - (Bj) 

30 bits 

04ijK 

NE 

Bi,K 

Branch to K if (Bi) 5 ^ 0 

30 bits 

OSiOK 

NE 

Bi,Bj,K 

Branch to K if (Bi) 4 (Bj) 

30 bits 

OSijK 

NZ 

Bi,K 

Branch to K if (Bi) 7 ^ 0 

30 bits 

OSiOK 

PL 

Bi,K 

Branch to K if (Bi) > 0 

30 bits 

06iOK 

GE 

Bi,K 

Branch to K if (Bi) > 0 

30 bits 

06i0K 

GE 

Bi,Bj,K 

Branch to K if (Bi) > (Bj) 

30 bits 

06ijK 

LE 

Bj,Bi,K 

Branch to K if (Bj) < (Bi) 

30 bits 

06ijK 

LE 

Bj,K 

Branch to K if (Bj) < 0 

30 bits 

oeojK 

NG 

Bi,K 

Branch to K if (Bi) < 0 

30 bits 

07i0K 

Ml 

•Bi,K 

Branch to K if (Bi) < 0 

30 bits 

07i0K 

GT 

Bj,Bi,K 

Branch to K if (Bj) > (Bi) 

30 bits 

07ijK 

GT 

Bj,K 

Branch to K if (Bj) >0 

30 bits 

070jK 

LT 

Bi,K 

Branch to K if (Bi) <0 

30 bits 

OTiOK 

LT 

Bi,Bj,K 

Branch to K if (Bi) < (Bj) 

30 bits 

1 

07ijK 
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Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE COMMENTS 


\ 


It 

IB Uq 

0'>50005221 + 



ZR 

B5,BZER0 1 

01*05005222 + 



EQ 

BO,B5,EQUAL | 

01*53005223 + 



EQ 

B5,B3,JUMP 1 

01*00005223 + 



EQ 

JUMP 

0515005224 + 



NE 

B1,B5,NOTEQ ' 

0560005225 + 



NZ 

B6,BNOTZR ' 

1 

0620005226 + 



PL 

1 

B2,BPLUS 1 

0645005227 + 



GE 

B4,B5,GEQ | 

J 

0650005230 + 



GE 

B5,GEB0 1 

1 

0676005231 + 



1 

LE 

1 

B6,B7,LTHAN | 

0770005232 + 



NG 

B7,BNEG I 

0730005233 + 



MI 

B3,B3LTO ! 

1 

0767005234 + 



GT 

B7,B6,B7GT f 

0705005235 + 



GT 

B5,B5GT0 I 

1 

0712005236 + 



LT 

B1,B2,BLTB l 


8.4J 7 TRANSMIT INSTRUCTION 

This instruction transfers the 60-bit word in operand register Xj to register Xi. It is essentially a copy 
instruction intended for moving data from X register to X register as quickly as possible. No logical 
function occurs. The assembler sets the k designator to the value specified for j. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

BXi 

Xj 

Transmit (Xj) to Xi 

15 bits 

lOijj 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


t 


11 

IB 

|30 

10622 



BX6 

^C2 -1- 
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8.4.18 LOGICAL PRODUCT INSTRUCTION 


This instruction forms the logical product (AND function) of 60-bit words from operand registers Xj and Xk 
and places the product in operand register Xi. Bits of register Xi are set to 1 when the corresponding bits 
of the Xj and Xk registers are 1 as in the following example; 

(Xj) = 0101 
(Xk) = 1100 
(Xi) = 0100 

This instruction is intended for extracting portions of a 60-bit word during data processing. If the j and k 
designators have the same value, the instruction becomes a transmit instruction. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

BXi 

Xj*Xk 

Logical product of (Xj) and (Xlc) to Xi 

15 bits 

llijk 


Example: 

Code Generated 


11553 



LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


11 

1 G ho 



BX5 

X5»X3 1 


8.4.19 LOGICAL SUM INSTRUCTION 

This instruction forms the logical sum (inclusive OR) of 60-bit words from operand registers Xj and Xk and 
places the sum in operand register Xi. A bit of register Xi is set to 1 if the corresponding bit of the Xj or 
Xk register is a 1, as in the following example: 

(Xj) = 0101 
(Xk) = 1100 
(Xi) = 1101 

This instruction is intended for merging portions of a 60-bit word into a composite word during data 
processing. If the j and k designators have the same value, the instruction degenerates into a transmit 
instruction. 


Format: 


Operation 

Variable 

Description 

Si ze 

Octal Code 

BXi 

Xj+Xlc 

Logical sum of (Xj) and (Xlc) to Xi 

15 bits 

12ijk 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


It 

IB 

ho 

12767 



BX7 

|X6+X7 
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8.4.20 LOGICAL DIFFERENCE INSTRUCTION 


This instruction forms the logical difference (exclusive OR) of 60-bit words from operand registers Xj and 
Xk and places the difference in operand register Xi. A bit in register Xi is set to 1 if the corresponding 
bits in the Xj and Xk registers are unlike, as in the following example: 

(Xj) = 0101 
(Xk) = 1100 
(Xi) =1001 

This instruction is intended for comparing bit patterns or for complementing bit patterns during data 
processing. If the j and k designators have the same value, the result will be a word of all zeros written 
into register Xi. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

BXi 

Xj-Xlc 

Logical difference of (Xj) and (Xlc) to Xi 

15 bits 

13ijk 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


11 

IB 

I 30 






13601 



BX6 

X0-X1 I 


8.4.21 COMPLEMENT INSTRUCTION 

This instruction extracts the 60-bit word from operand register Xk, complements it, and transmits this 
complemented quantity to operand register Xi. It is intended for changing the sign of a fixed point or 
floating point quantity as quickly as possible. 

The assembler sets the unused j designator of the instruction to k. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

BXi 

-Xlc 

Transmit complement of (Xlc) to Xi 

15 bits 

14ikk 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


11 

IB 

[30 

14311 



BX3 ■ 

Pin -!- 
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8.4.22 LOGICAL PRODUCT AND COMPLEMENT INSTRUCTION 

This instruction forms the logical product (AND function) of the 60-bit quantity from operand register X 
and the complement of the 60-bit quantity from operand register XIc, and places the result in operand 
register Xi. Thus, bits of Xi are set to 1 when the corresponding bits of the Xj register and the 
complement of the Xk register are 1, as in the following example: 

(Xj) =0101 
Complemented (Xk) = 0011 
(Xi) = 0001 

This instruction is intended for extracting portions of a 60-bit word during data processing. If the j and k 
designators have the same value, a logical product is formed between two complementary quantities. The 
result will be a word of cdl zeros. 


Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

BXi 

-Xlc*Xj 

Logical product of (Xj) and compleinent 
of (Xlc) to Xi 

15 bits 

ISijk 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


ti 

IB 

[30 

15'>32 



BXJi 

-X2»X3 1 


8.4.23 COMPLEMENT AND LOGICAL SUM INSTRUCTION 

This instruction forms the logical sum (inclusive OR) of the 60-bit quantity from operand register Xj and^ 
the complement of the 60-bit word from operand register Xk, and places the result in operand register Xi. 
Thus, bits of Xi are set to 1 if the corresponding bit of the Xj register is one or the corresponding bit of the 
Xk register is a 0, as in the following example: 

(Xj) = 0101 
(Xk) = 1100 
(Xi) = 0111 

This instruction is intended for merging portions of a 60-bit word into a composite word during data 
processing. If the j and k designators have the same value, the result is a word of all ones. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

BXi 

-Xlc+Xj 

Logical sum of (Xj) and complement of 
(Xk) to Xi 

15 bits 

IGijk 


Example; 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


11 

18 

|30 





- 

lees'! 



Bxe 

-XM+X5 i 
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8,4,24 COMPLEMENT AND LOGICAL DIFFERENCE INSTRUCTION 


This instruction forms the logical difference (exclusive OR) of the quantity from operand register Xj and 
the complement of the 60-bit word from operand register Xk, and places the result in operand register Xi. 
Thus, bits of Xi are set to 1 if the corresponding bits of Xj and register Xk are alike, as in the following 
example: 

(Xj) = 0101 
(Xk) =1100 
(Xi) =0110 

This instruction is intended for comparing bit patterns or for complementing bit patterns during data 
processing. If the j and k designators have the same value, a logical difference is formed between two 
complementary quantities. The result is a word of all ones. 

Format! 


Operation 

Variable 

Description 

Size 

Oclal Code 

BXi 

-Xlc-Xj 

Logical difference of (Xj) and complement 
of (XIv) to Xi 

15 bits 

17ijk 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABU 

COMMENTS 


I 


n 

IQ 

ho 





-- 

17731 



BX7 

-X1-X3 1 


8.4,25 LOGICAL LEFT SHIFT jk PLACES INSTRUCTION 

This instruction shifts the 60-bit word in operand register Xi left circular jk places if expression jk is 
positive or left circular 60+jk places if jk is negative. Bits shifted off the left end of operand register Xi 
replace those shifted from the right end. 

The 6-bit shift count jk allows a complete circular shift of (Xi). 

In COMPASS notation, jk is an absolute expression. If it is positive, COMPASS places the lower 6 bits of 
the value in the jk fields. If it is negative, COMPASS adds 60 to jk and places the result in the jk fields. 
Thus, a negative value effectively designates a logical right shift. A positive value designates a left shift. 

If the negative shift count is less than -60, the assembler generates a type 7 error. 

Format: 


Operation 

Variable 

Description 

Si ze 

-r 

Octal Code j 
-1 

LXi 

Jk 

Logical shift (Xi) by jk places 

15 bits 

20ijk 
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Example: 




LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

Code Generated 

J 


11 

18 

ho 

20325 



LX3 

25B 

1 - 

l 

1 

20362 



LX3 

-12B 

1 

1 


8.4.26 ARITHMETIC RIGHT SHIFT jk PLACES INSTRUCTION 

This instruction shifts the 60-bit word in operand register Xi right jk places if expression jk is positive and 
right 60+jk places if expression jk is negative. The rightmost bits of Xi are discarded and the sign bit is 
extended. 

If the shift count is equal to the 60-bit register length, the result contains 60 copies of the sign bit. If the 
operand is positive, a positive zero results. If the operand is negative, a negative zero results. 

In COMPASS notation, jk is an absolute expression. If it is positive, COMPASS places the lower 6 bits of 
the value in the jk fields. If it is negative, COMPASS adds 60 to jk and places the result in the jk fields. 
Thus, a negative value effectively designates the number of high order bits of the operand that are to be 
retained. If the negative shift count is less than -60, a type 7 error is generated. 


Format; 


Operation 

Variable 

Description 

Size 

Octal Code 

AXi 

jk 

Arithmetic shift (Xi) by ± jk places 

15 bits 

21ijk 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


11 

18 

ho 

21537 



AX5 

I37B 1 


8.4.27 LOGICAL LEFT SHIFT (Bj) PLACES INSTRUCTION 

This instruction shifts the 60-bit quantity from operand register Xk the numbo* of places specified by the 
quantity in index register Bj and places the result in operand register Xi. The Erection of the shift 
operation is determined by the sign of Bj, as follows: 

If (Bj) is positive (that is, bit 17 of Bj=0), the quantity from Xk is shifted left drcular. The low order 6 
bits of (Bj) specify the shift count. The higher bits are ignored. 

If (Bj) is negative (that is, bit 17 of Bj=l), the quantity from Xk is shifted right (end off with sign 
extension). For the CYBER 180 Series; the CYBER 170 Series (except Model 176); the CYBER 70 
So’ies Models 71, 72, 73, and 74; and the 6000 Series, the one’s complement of the low order 11 bits of 
(Bj) specify the shift count. The higher orde* bits are ignored. If the shift count is 59 to 63 (decimal), 
the result stored in the Xi register consists of 60 copies of the operand sign bit. If the shift count is 64 
(decimal) or greater, the result register Xi is cleared to 60 zeros. For the CYBER 170 Model 176, 
CYBER 70 Model 76 and the 7600, the one’s complement of the low OTder 12 bits of (Bj) specifies the 
shift count. The higher or da* bits are ignored. If the shift count is 59 (decimal) or great e*, the result 
stored in the Xi register consists of 60 copies of the operand sign bit. 
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If -Bj is specified, the assembler converts the instruction to an arithmetic right shift. The (Bj) might be 
the result of an unpack instruction, in which case it is the unbiased exponent and (Xi) is the coefficient. 
This instruction is used for shifting a coefficient from a floating point number to the integer position after 
an unpack operation. 


Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

LXi 

Xk, Bj 

Logically shift (Xk) by (Bj) places to Xi 

15 bits 

22ljk 

LXi 

Bj,Xk 

Logically shift (Xk) by (Bj) places to Xi 

15 bits 

22ijk 

LXi 

Xk 

Transmit (Xk) to Xi 

15 bits 

22i0k 

LXi 

Bj 

Logically shift (Xi) by (Bj) places to Xi 

15 bits 

22iji 

LXi 

-Bj.Xk 

Arithmetic right shift (Xk) by (Bj) 
places to Xi 

15 bits 

2:Hjk 

LXi 

Xk,-Bj 

Arithmetic right shift (Xk) by (Bj) 
places to Xi 

15 bits 

23ijk 

LXi 

-Bj 

Arithmetic right shift (Xi) by (Bj) 
places to Xi 

15 bits 

23iji 1 


Example: 

Code Generated 


22675 

2253'i 

22302 



lOCATlON 

OPERATION 

VARIABLE 

COMMENTS 

1 


11 

\B 

|30 







LX6 

X5,B7 

-1- 

1 



LX5 

B3,Xi) 

1 

1 



LX3 

X2 

1 

1 


8.4.28 ARITHMETIC RIGHT SHIFT (Bj) PLACES INSTRUCTION 

This instruction shifts the 60-bit quantity from operand register Xk the number of places specified by the 
quantity in index register Bj and places the result in operand register Xi. The drection of the shift 
operation is determined by the sign of Bj, as follows: 

If (Bj) is positive (that is, bit 17 of Bj=0), the quantity from register Xk is shifted right (end off with 
sign extension). For the CYBER 180 Series; the CYBER 170 Series (except Model 176); the CYBER 70 I 
Models 71, 72, 73, and 74; and the 6000 Series computer systems, the low order 11 bits of (Bj) specify | 
the shift count. The higher order bits are ignored. If the shift count is 59 to 63 (decimal), the Xi 
register contains 60 copies of the (Xk)sign bit. If the shift count is 64 (decimal) or more, the Xi 
register is zeroed. For the CYBER 170 Model 176, CYBER 70 Model 76, or 7600 computer systems, 
the low order 12 bits of (Bj) specify the shift count. The higher order bits are ignored. If the shift 
count is 59 (decimal) or more, the Xi register contains 60 copies of the sign of the operand. 

If (Bj) is negative (that is, bit 17 of Bj=l), the quantity from register Xk is shifted left circular. The 
complement of thelowo’ order 6 bits of Bj specify the shift count. The higher orde- bite are ignored. 
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If -B is specified, the assembler converts the instruction to a logical left shift. This instruction is intended 
for use in data processing where the amount of shift is derived in the computation. This instruction is also 
useful for adjusting the coefficient of a floating point number while it is in its unpacked form. 


Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

AXi 

XU, Bj 

Arithmetic sliiR of (Xk) by (Bj) places to Xi 

15 bits 

25iik 

AXi 

Bj.Xk 

Arithmetic shift of (Xk) by (Bj) places to Xi 

15 bits 

2;jijk 

AXi 

Xk 

Transmit (Xk) to Xi 

15 bits 

2:Ji()k 

AXi 

Bj 

Arithmetic shift of (XI) by (Bj) places to Xi 

15 bits 

231] 1 

AXi 

-Bj, Xk 

Logically shift (Xk) by (Bj) places U) Xi 

15 bits 

22ijk 

AXi 

Xk, -Bj 

Logically shift (Xk) by (Bj) places to Xi 

15 bits 

22ijk 

AXi 

-Bj 

Logically shift (Xi) by (Bj) places to Xi 

15 hits 

22iji 


Example: 

Code Generated 


237611 

23211 

23502 



8.4.29 NORMALIZE INSTRUCTION 

This instruction normalizes the floating point quantity from operand register Xk and places it in operand 
register Xi. Normalizing consists of shirting the coefficient the minimum number of positions required to 
make bit 47 different from bit 59. This places the most significant bit of the coefficient in the highest 
order position of the coefficient portion of the word. The exponent portion of the word is then decreased 
by the number of bit positions shifted. The number of shifts required to normalize the quantity is entered 
in index register Bj. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

NXi 

Xlv 

Normalize (XIx) to Xi 

15 bits 

2-1 iOk . 

NXi 

Bj.Xlc 

Normalize (Xlv) to Xi; shift count to Bj 

15 bits 

2-Jijk 

NXi 

Xlc, Bj 

Normalize (Xk) to Xi; shift count to Bj 

15 bits 

2-1 ijk 

NXi 


Normalize (Xi) to Xi 

15 bits 

24i()i 

NXi 

Bj 

Normalize (Xi) to Xi; shift count to Bj 

lt5 bits 

2-1 iji 
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Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


II 

ie 

1 30 





r- 1 -- --- 

24575 



NX5 

X5,B7 

- ^ 

1 

24505 



NX5 

X5 

1 

1 

24552 



NX5,B5 

X2 

1 


8.4.30 ROUND AND NORMALIZE INSTRUCTION 

This instruction performs the same operation as the NXi instruction with the exception that the quantity 
from operand register Xk is rounded before it is normalized. Rounding is accomplished by placing a 1 round 
bit immediately to the right of the least significant coefficient bit. The resulting coefficient is increased 
by one-half the value of the least significant bit. Normalizing a zero coefficient places the round bit in bit 
47 and reduces the exponent by 48. Note that the same rules apply for underflow, overflow, infinite, and 
indefinite results. 

If (Xk) is an infinite quantity (3777x.. .Xg or 4000x.. .xg) or an indefinite quantity (1777x.. .xg or 
GOOOx,. ,xg), no shift takes place. The contents of Xk are copied into Xi, and Bj is set to zero. 

Format; 


Operation 

Variable 

Description 

Size 

Octal Code 

ZXi 

Xlc 

Round and normalize (Xk) to Xi 

15 bits 

25i0k 

ZXi 

Bj.XIc 

Round and normalize (Xlc) to Xi; shift 





coimt to Bj 

15 bits 

25ijk 

ZXi 

Xli.Bj 

Round and normalize (Xk) to XI; shift 





count to Bj 

15 bits 

25ijk 

ZXi 

Bj 

Round and nonnalize (Xi) to Xi; shift 





count to Bj 

15 bits 

25iji 

ZXi 


Round and normalize (Xi) to Xi 

15 bits 

25i0i 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


\ 


a 

IB 

[30 

25474 



ZX4 

X4,B7 

-^--- 

1 

25404 



ZX4 


1 

1 

25361 



ZX3,B6 

XI 

1 

1 


8.4.31 UNPACK INSTRUCTION 

This instruction unpacks the floating point quantity from operand register Xk and sends the 48-bit 
coefficient to operand register Xi and the 11-bit exponent to index register Bj. The exponent packing is 
removed during unpack so that the quantity in Bj is the true one^s complement representation of the 
exponent. The contents of Xk need not be normalized. 
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The exponent and coefficient are sent to the low-order bits of the respective registers, as shown below: 



Special operand formats are treated in the same manner as normal operands* 
Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

UXi 

Xk 

Unpack pcic) to Xi 

15 bits 

26i0k 

UXi 

Bj.Xk 

Unpack (Xlc) to Xi and Bj 

15 bits 

26ijk 

UXi 

Xlc.Bj 

Unpack (Xlc) to Xi and Bj 

15 bits 

26ijk 

UXi 


Unpack (Xi) to Xi 

15 bits 

26i0i 

UXi 

Bj 

Unpack (Xi) to Xi and Bj 

15 bits 

26iji 


Example; 


Code Generated 


lOCATION 

OPERATION 

VARIABLE 

COMMENTS 


I 


11 

ia 

|30 

26777 



UX7 

X7,B7 

-1--- 

1 

26342 



UX3,X2 

B4 

1 

1 

1 

26707 



1 

UX7 

1 

1 

j 

1 

26777 



UX7 1 

|b7 

1 

1 


8.4.32 PACK INSTRUCTION 

This instruction packs a floating point number in operand register xi. The coefficient of the number is 
obtained from operand register Xk and the exponent is obtained from index register Bj. The exponent is 
packed by reversing the setting of bit 10 of the exponent during the pack operation. The pack instruction 
does not normalize the coefficient. 

Exponent and coefficient are obtained from the proper low-order bits of the respective registers and 
packed in reverse order as shown in the illustration for the unpack instruction. Thus, bits 58 through 48 of 
Xk and bits 17 through 11 of Bj are ignored. There is no test for overflow or underflow. No flags are set in 
the PSD register by this instruction. 
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Note that if (Xk) is positive, the packed exponent occupying bits 58 through 48 of Xi is obtained from bits 
10 through 00 of Bj by complementing bit 10; if (Xk) is negative, bit 10 is not complemented but bits 09 
through 00 are complemented- 

The j designator can be set to zero in this instruction to pack a fixed point integer into floating point 
format without using one of the active B registers (exponent=0). 

Format: 


Operation 

Variable 

Description 

Size 

Octal Corle 

PXi 

Xl^ 

Pack (Xlc) to Xi 

15 bits 

27i0k 

PXi 

Xl^, Bj 

Pack (Xlc) and (Bj) to Xi 

15 bits 

27ijk 

PXi 

Bj, Xlc 

Pack (Xlc) and (Bj) to Xi 

15 bits 

27ijk 

PXi 


Pack (Xi) to Xi 

15 bits 

27i0i 

PXi 

Bj 

Pack (Xi) and (Bj) to Xi 

15 bits 

27iji 


Example; 

Code Generated 


27565 

27671 

27505 

27565 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


11 

IB 

Iso 



PX5 

X5,B6 

i 



PX6,B7 

XI 

j 

j 


1 

PX5 

1 

i 

1 


i 

1 

PX5 

B6 

1 


8.4.33 UNROUNDED SP FLOATING POINT ADD INSTRUCTIONS 

These instructions form the unrounded sum or difference of the floating point quantities from operand 
registers Xj and Xk and pack the result in operand register Xi- The packed result is the upper half of a 
double precision sum or difference. 

At the start both arguments are unpacked, and the coefficient of the argument with the smaller exponent 
is entered into the upper half of the accumulator- The coefficient is shifted right by the difference of the 
exponents. The other coefficient is then added to or subtracted from the upper half of the accumulator. If 
overflow occurs, the result is right-shifted one place and the exponent of the result increased by one. The 
upper half of the accumulator holds the coefficient of the result, which is not necessarily in normalized 
form. The exponent and upper coefficient are then repacked in operand register Xi. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

FXi 

Xj-fXlc 

Floating point sum of (Xj) and (Xlc) to Xi 

15 bits 

30ijk 

FXi 

Xj-Xlc 

Floating point difference of (Xj) minus 
(Xlc) to Xi 

15 bits 
_ 1 

31ijk 
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Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


11 

IB 

|30 

303M5 



FX3 

X1I+X5 

-1.... 

1 

31213 



FX2 

m 

>< 

X 

1 

f 


8.4.34 DP FLOATING POINT ADD INSTRUCTIONS 

These instructions form the sum or difference of two floating point numbers as in the single precision 
instructions, but pack the lower half of the double precision result with an exponent 48 less than the upper 
sum. The result is not necessarily normalized. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

DXi 

Xj+Xk 

Floating DP sum of (Xj) and (Xlc) to Xi 

15 bits 

32ijk 

DXi 

X]-Xlc 

Floating DP difference of (Xj) and (Xlc) 
to Xi 

15 bits 

33ijk 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE COMMENTS 

32323 

33414 

2 


tl 

18 ho 



DX3 

DX4 

X2+X3 1 

1 

X1-X4 j 


8.4.35 ROUNDED SP FLOATING POINT ADD INSTRUCTIONS 

These instructions form the rounded sum or difference of the floating point quantities from operand 
registers Xj and Xk and pack the upper portion of the double precision result in operand register Xi. These 
instructions are intended for use in floating point calculations involving single precision accuracy. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

RXi 

Xj+Xlc 

Rounded floating sum of (Xj) and (Xlc) 
to Xi 

15 bits 

34ijk 

RXi 

Xj-Xl; 

Rounded floating difference of (Xj) minus 
(Xlc) to Xi 

15 bits 

35ijk 
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Example; 


Code Gfenerated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


n 

IB 

ho 

34534 



RX5 

X3+X4 

-1-^ 

1 

35653 



RX6 

X5-X3 

1 

1 

1 


8.4.36 LONG ADD (FIXED POINT) INSTRUCTIONS 

These instructions form the 60-bit one^s complement integer sum or integer difference of quantities from 
operand registers Xj and Xk and store the result in operand register Xi. An overflow condition is ignored. 

The instructions are intended for addition or subtraction of integers too large for handling in the increment 
unit. They are also useful for merging and comparing data fields during data processing. 

For an addition, if both operands are zero, the result is zero. If either zero operand is positive zero (all 
zeros), the result is a positive zero quantity. If both operands are minus zero (all ones), the result is a 
negative zero quantity. 

Format; 


Operation 

Variable 

Description 

Size 

Octal Code 

Ki 

Xj+Xlc 

Integer sum of (Xj) and (Xlc) to Xi 

15 bits 


IXi 

Xj-Xlc 

Integer difference of (Xj) minus (XIc) 
to Xi 

15 bits 



Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


ir 

IQ 

ho 

36545 



1X5 

X4+X5 

-j- 

1 

1 

37631 



1X6 

X3-X1 

1 

1 


8,4.37 UNROUNDED SP FLOATING POINT MULTIPLY INSTRUCTION 

This instruction multiplies two floating point quantities obtained from operand registers Xj (multiplier) and 
Xk (multiplicand) and paclcs the upper product result in operand register Xi. 

In this operation, the exponents of the two operands are unpacked from the floating point format and are 
added with a correction factor of 48 to form the exponent for the result. The coefficients are multiplied 
as signed integers to form a 96-bit integer product. The upper half of this product is then extracted to 
form the coefficient of the result. The result is a normalized quantity only when both operands are 
normalized; the exponent in this case is the sum of the exponents plus 47 (or 48). The result is not 
normalized when either or both operands are not normalized. 
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Format: 


Operation 

Variable 

Description 

Size 


FXi 

Xj+XIc 

Floating point product of (Xj) and 
(Xk) to Xi 

15 bits 

40ijk 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


n 

IB 

i30 





-1- 

40011 


i 

FXO 

X1»X1 1 

1 


8.4.38 ROUNDED SP FLOATING POINT MULTIPLY INSTRUCTION 

This instruction multiplies the floating point number from operand register Xk (multiplicand), by the 
floating point number from operand register Xj. The upper product result is packed in operand 
register Xi. (No lower product is available.) The multiply operation is identical to that of the single 
precision instruction except that a rounding bit is added in bit position 46 of the SG-bit product. The upper 
half of the product is then extracted to form the coefficient for the result. An alternate output path is 
provided with a left shift of one bit position to normalize the result coefficient if the original operands 
were normalized and the double precision product has only 95 bits of significance. The exponent for the 
result is decremented by one count in this case. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

RXi 

Xj*Xlc 

Rounded floating point product of (Xj) 
and (Xlc) to Xi 

15 bits 

41ijk 


Example: 


Code Generated 


LOCATION 

OPERATION 

variable 

COMMENTS 


I 


li 

IB 

l30 

41232 



RX2 

X3»X2 i 

1 


8.4.39 DP FLOATING POINT MULTIPLY INSTRUCTION 

This instruction multiplies two floating point quantities obtained from operand registers Xj and Xk and 
packs the lower product in operand register Xi. The two 48-'bit coefficients are multiplied together to 
form a 96'-bit product. The lower order 48 bits of the product (bits 47 through 0) are then packed together 
with the resulting exponent. The result is not necessarily normalized. The exponent of this result is 48 less 
than the exponent resulting from an unrounded single precision instruction using the same operands. 
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This instruction is intended for use in multiple precision floating point calculations. It may also be used to 
form the product of two integers providing the resulting product does not exceed 48 bits of significance. 
The operands must be packed in floating point format before executing this instruction. The results must 
be unpacked to obtain the integer product. 


Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

DXi 

Xj*Xlc 

Floating point DP product of (Xj) and 
(XIO to Xi 

15 bits 

42ijU 


Example: 


Code Generated 


LOCATION 

OPEKATION 

VARIABLE 

COMMENTS 


\ 


li 

ie 

|30 

H2345 



DX3 

Xi|»X5 

■ -I- 

1 


8.4,40 INTEGER MULTIPLY INSTRUCTION 

The CPU integer multiply instruction is, to COMPASS, synonymous with the double precision floating point 
multiply instruction. Regardless of how it is written in COMPASS, the 42ijk instruction is executed as 
follows: If each operand register has all zeros or aU ones in its leftmost 12 bits, the 47-bit integer product 
is formed in Xi with sign extension in its leftmost 12 bits. (Exception: if each operand has bit 47 different 
from its sign bit, the result is shifted left one bit position.) Otherwise, a double precision floating point 
multiplication is performed. Thus, there is no need to pack exponents into the operands, and unpack the 
result, for an integer multiply, COMPASS provides the alternate symbolic representations IXi Xj*Xk and 
DXi Xj*Xk for the 42ijk instruction as an aid to program readability, so the programmer can indicate 
whether or not the instruction is being used for integer multiplication. 

Format: 


OiTeration 

Variable 

Description 

Size 

Octal Code 

IXi 

Xj*Xlv 

Integer product of (Xj) and (Xlc) to Xi 

15 bits 

42ijk 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE COMMENTS 

42234 



n 

IB ho 



I<2 

i 

X3*X4 1 

1 
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8.4,41 MASK INSTRUCTION 


This instruction clears register Xi and forms a mask in it, A positive value for expression jk defines the 
number of ones in the mask as counted from the highest order bit in Xi, A negative value for expression jk 
defines the number of 0 bits (unmasked) counted from the low order bit in Xi. The completed masking 
word consists of ones in the high order bit positions of the word and zeros in the remainder of the word. 

The contents of operand register i are zero when jk is zero. The contents of operand register i are all ones 
when jk is 60. 

This instruction is intended for generating masks for logical operations. Used with the shift instruction, 
this instruction creates an arbitrary field mask faster than by reading a previously generated mask from 
storage. 

In COMPASS notation, if the veilue of absolute expression jk is positive, the assembler inserts it into the jk 
field of the assembled instruction. If the value of absolute expression jk is negative, the assembler adds 60 
to the expression value and places the sum in the jk field of the assembled instruction. 

A negative jk value less than «60 results in a type 7 assembly error. 


Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

MXi 

jk I 

Form mask in Xi, h- jk bits 

15 bits 

LO 

1 

\ 

1 

!_ 


Example: 

Code Generated 
43U42 
43360 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

t 


tl 

10 

|ao 







MXO 


i 

1 

1 



MX3 

-14b 

1 

1 


8.4.42 UNROUNDED SP FLOATING POINT DIVIDE INSTRUCTION 

This instruction divides two normalized floating point quantities obtained from operand registers Xj 
(dividend) and Xk (divisor) and packs the quotient in operand register Xi. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

FXi 

Xj/Xlc 

Floating point divide of (Xj) by (Xlv) 
to Xi 

15 bits 

44ijk 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


M 

IB 

\lD 

uueji 1 



FX6 

X :^ / X 1 I 
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8.4.43 ROUNDED SP FLOATING POINT DIVIDE INSTRUCTION 


This instruction divides the floating quantity from operand register Xj (dividend) by the floating point 
quantity from operand register Xk (divisor) and paelcs the rounded quotient in operand register Xi. 

Format: 


Operation 

Variable 

Description 

Si x.c 

Octal Code 

RXi 

Xj/xiv 

Rounded floating point division of (Xj) 
by (Xli) to Xi 

]n hits 

45ijk 


Example; 


Code Generated 


LOCATION 

OPERATION 

VARIABLE COMMENTS 


1 


II 

Ifi |3D 

H5721) 



RX7 

X2/X1I 1 


8.4.44 PASS INSTRUCTION 

The no-operation (pass) instruction is not associated with a functional unit. This instruction is a do-nothing 
instruction used typically to pad the program between steps. An integer value in the variable field 
(optional) is inserted into the lower 8 bits of the instruction. The assembler automatically pads the 
remainder of a word whenever a force upper occurs; in this case, the programmer is not required to insert 
the NO. 

On a machine with a Compare/Move Unit (CMU), a value of n greater than or equal to 400g causes the 
instruction to be interpreted as a CMU instruction. 

On CYBER 170 Models 175, 740, 750, and 760, a value of n greater than or equal to 40 O 3 is illegal. 

Format; 


Operation 

Variable 

Description 

Size 

Octal Code 

NO 


Pass 

15 bits 

46000 

NO 

n 

Pass 

15 bits 

46 n 


Example; 


Code Generated 


LOCATION 

OPERATION 

VARIABLE COMMENTS 

iibOOO 

I 


li 

10 |3Q 



NO 

-1-- 

1 


8.4.45 POPULATION COUNT INSTRUCTION 

This instruction counts the number of 1 bits in operand register Xlc and stores the count in the lower order 
6 bits of operand register Xi. Bits 59 through 06 are cleared. 
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If Xk is a word of all ones, a count of 60 (decimal) is delivered to the Xi register. If Xk is a word of all 
zeros, a zero word is delivered to the Xi register. 

The assembler sets the unused j designator to k. 

Format: 


Operation 

Variable 

Description 

— 

Size 

.. 

Octal Code 

CXi 

Xlc 

Count of number of l^s in (Xlv) to Xi 

... 

15 bits 

47iltli 


Example: 


Code Generated 


LOCATION 

OPERATION 

variable 

COMMENTS 


1 


t) 


I 30 






117700 



CX7 

o 

X 


8.4.46 SET A REGISTER INSTRUCTIONS 

These instructions are intended for fetching operands from storage for computation and for delivering 
results back into storage. The instructions have two destination registers: the Ai register, which receives 
the address formed from the operands, and either the Xi register or a CM (SCM) storage location. 

Operands are obtained from address (A), index (B), and operand (X) registers as well as from the 
instruction itself (K = 18-bit operand). Operands obtained from an Xj operand register are the truncated 
lower 18 bits of the 60-bit word. The highest order bits are ignored; an overflow condition is also ignored. 

If the i designator is nonzero, a storage reference is made using the lower 15, 16, or 17 bits of the resulting 
sum or difference as the relative storage address depending on machine size. The upper bits are ignored. 
The type of storage reference is a function of the i designator value, as follows: 

i = 0; no storage reference 

i = 1, 2, 3, 4, or 5; contents of CM (SCM) relative address (Ai) to register Xi 
i = 6 or 7; contents of register Xi stored at CM (SCM) relative address (Ai) 
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Format! 


Operation 

Variable 

Description 

Si zo 

Octiil Code? 

SAi 


Set Ai to (Aj) K 

.no hits 

50ijK 

SAi 

mm 

Set Ai to K 

30 bits 

51iOK 

SAi 


Set Ai to (Bj) K 

30 bits 

51ijK 

SAi 

Xj+K 

Set Ai to (Xj) j_ K 

30 bits 

52ijK 

SAi 

Xj 

Set Ai to (Xj) 

15 bits 

53ij0 

SAi 

Xj+Bk 

Set Ai to (Xj) ^ (Bk) 

15 bits 

53ijk 

SAi 

Bk+Xj 

Set Ai to (Xj) ^ (Bk) 

15 bits 

53ijk 

SAi 

Aj 

Set Ai to (Aj) 

15 bits 

54ij0 

SAi 

Aj+Bk 

Set Ai to (Aj) + (Bk) 

15 bits 

54ijk 

SAi 

Bk +Aj 

Set Ai to (Aj) I- (Bk) 

15 bits 

54ijk 

SAi 

Aj-Bk 

Set Ai to (Aj) - (Bk) 

15 bits 

55ijk 

SAi 

-Bk+Aj 

Set Ai to (Aj) - (Bk) 

15 bits 

55ijk 

SAi 

Bj 

Set Ai to (Bj) 

15 bits 

5()ij0 

SAi 

Bj+Bk 

Set Ai to (Bj) 1 (Bk) 

15 bits 

50ijU 

SAi 

-He 

Set Ai to (BO) - (Bk) 

15 bits 

57i0k 

SAi 

Bj-Hc 

Set Ai to (Bj) - (Bie) 

15 bits 

57ijk 

SAi 

-Bk-iBj 

Set Ai to (Bj) - (Bk) 

15 bits 

57ijk 


Example: 


Code Generated 


LOCATION 

OPERATION 

VAHlABlf 

COMMENTS 


± 


U 

IB 

1 30 

5010000001 



SAI 

AO+1 

-h- 

r 

1 

5100777774 



SAG 

-3 

l 

1 

5121000003 



SA2 

3+B1 

1 

1 

5231777771 



SA3 

X1-6 

[ 

1 

53411 



SA4 

X1+B1 

1 

1 

54541 



SA5 

A4+B1 

1 

1 

54641 1 

1 



SA6 

A4+B1 

1 

! 

54540 



SA5 

A4 

1 

1 

55641 1 



SA6 

-B1+A4 

1 

56711 

! 


SA7 

B1+B1 

1 

57721 



SA7 

B2-B1 

1 

1 


( 
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8.4.47 DIRECT READ/WRITE CENTRAL MEMORY 

These instructions permit information to be stored into central memory from the specified X register or to 
be loaded from central memory into the X register. The lower 21 bits of Xk specify the central memory 
address relative to RAq. The other bits of Xlc are unused. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

CR 

Xj.Xlc 

Read CM at (Xk) to Xj ! 

15 bits 

660jk 

CW 

Xj.Xk 

Write Xj to CM at (Xk) 

1 

15 bits I 

i 

670jk 


Example: 




LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

Code Generated 

I 


II 

IB 

30 

6601 2 



CR 

XI ,X2 


6 7012 



CW 

X1 ,X2 



8.4.48 SET B REGISTER INSTRUCTIONS 

These instructions perform one^s complement addition and subtraction of 18~bit operands and store an 
18-bit result in index register Bi. Note the result will never be negative zero (all ones) unless negative 
zero is added to negative zero. 

Operands are obtained from address (A), index (B), and operand (X) registers as well as from the 
instruction itself (K = 18-bit operand). Operands obtained from an Xj operand register are the truncated 
lower 18 bits of the 60-bit word- The highest order bits are ignored; an overflow condition is also ignored. 

I lf the i designator is a zero, the instruction is a do-nothing instruction, except on the models 810, 815, 825, 
830, 835, 845, 855, 865, and 875 for which two forms of the SBO instruction (SBO Bj+Bk and SBO Bj-Bk) 
are invalid. On models 810, 815, 825, 830, 835, 845, 855, 865, and 875 the octal operation codes 660 and 
670 are interpreted as the CE and GW instructions, respectively* 
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Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

SBi 

Aj+K ' 

Set Bi to (Aj) + K 

30 bits 

60ijK 

SBi 

K 

Set Bi to K 

30 bits 

GliOK 

SBi 

Bj+K 

Set Bi to (Bj) + K 

30 bits 

61ijK 

SBi 

Xj+K 

Set Bi to (Xj) + K 

30 bits 

62ijK 

SBi 

Xj 

Set Bi to (Xj) 

15 bits 

63ij0 

SBi 

Xj-^Bk 

Set Bi to (Xj) H- (Bk) 

15 bits 

63ijk 

SBi 

Bk+Xj 

Set Bi to (Xj) + (Bk) 

15 bits 

63ijk 

SBi 

Aj 

Set Bi to (Aj) 

15 bits 

64ij0 

SBi 

Aj+Bk 

Set Bi to (Aj) -1 (Bk) 

15 bits 

64ijk 

SBi 

Bk■^Aj 

Set Bi to (Aj) -1* (Bk) 

15 bits 

G4ijk 

SBi 

Aj-Bk 

Set Bi to (Aj) ** (Blc) 

15 bits 

65ijk 

SBi 

-Bk-^Aj 

Set Bi to (Aj) - (Bk) 

15 bits 

G5ijk 

SBi 

Bj 

Set Bi to (Bj) 

15 bits 

GGijO 

SBi 

Bj+Bk 

Set Bi to (Bj) H (Bk) 

15 bits 

GGijk 

SBi 

-Bk 

Set Bi to (BO) - (Bk) 

15 bits 

67i0k 

SBi 

Bj-Bk 

Set Bi to (Bj) - (Bk) 

15 bits 

67ijk 

SBi 

-Bk+Bj 

Set Bi to (Bj) - (BIc) 

15 bits 

67ijk 
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Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 



ia 

ho 

6011777772 



SB1 

A1-5 

—1 - 

1 

6110777772 



SB1 

-5 

1 

1 

6121000011 



SB2 

3+B1+6 

1 

6231000100 



SB3 

X1+100B 

1 

1 

63^27 



SB4 

X2+B7 

1 

611541 



SB5 

A4+B1 

1 

1 

64540 



SB5 

A4 

I 

65641 



SB6 

-B1+A4 

1 

1 

65643 



SB6 

A4-B3 

1 

1 

66711 



SB7 

B1+B1 

1 

1 

67751 



SB7 

B5-B1 

1 

I 


8.4.49 SET X REGISTER INSTRUCTIONS 

The SXi instruetions perform one’s complement addition and subtraction of 18~bit operands and store an 
18“bit result into the lower 18 bits of operand register Xi- The sign of the result is extended to the upper 
42 bits of operand register Xi, An overflow condition is ignored. 

Operands are obtained from address (A), index (B), and operand (X) registers as well as the instruction 
itself (K = 18-bit operand). Operands obtained from an Xj register are the truncated lower 18 bits of the 
60-bit word. The highest order bits are ignored. 
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Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

SXi 

Aj-rK 

Set » to (Aj) + K 

30 bits 

70ijK 

SXi 

K 

Set Xi to K 

30 bits 

71i0K 

SXi 

Bj-K 

Set Xi to (Bj) i K 

30 bits 

71ijK 

SXi 

Xj-K 

Set Xi to (XJ) i K 

30 bits 

72ijK 

SXi 

Xj 

Set Xi to (Xj) 

15 bits 

73ij0 

SXi 

Xj+Bic 

Set Xi to (Xj) + (Bk) 

15 bits 

73ijk 

SXi 

Bk-^Xj 

Set Xi to (jq) + (Bk) 

15 bits 

73ijk‘ 

SXi 

Aj 

Set Xi to (Aj) 

15 bits 

74ij0 

SXi 

Aj+Bk 

Set M to (Aj) + (Bk) 

15 bits 

74ijk 

SXi 

Bk-Aj 

Set Xi to (Aj) + (Blv) 

15 bits 

74ij]v 

SXi 

Aj-Bk 

Set Xi to (Aj) - (Bk) 

15 bits 

75ijk 

SXi 

-Bk-Aj 

Set Xi to (Aj) - (Blx) 

15 bits 

75ijk 

SXi 


Set Xi to (Bj) 

15 bits 

7GijO 

SXi 

Bj-Bli 

Set Xi to (Bj) ^ (Bk) 

15 bits 

7Gijk 

SXi 

-Blc 

Set Xi to (BO) - (Bli) 

15 bits 

77i0k 

SXi ! 

Bj-Bk 

Set Xi to (Bj) - (Bk) 

15 bits 

77ijk 

SXi 1 

-Bk-Bj 

Set Xi to (Bj) - (Bk) 

15 bits 

77ijk 


Example: 


Code Generated 


LOCATION 

OPEIATION 

VAKfABLE 

COMMENTS* 


1 


11 

Ifl 

Uo 

7000005233 + 



sxo 

BNEG-4-A0+1 

-1.. 

1 

7110775755 



SXI 

-2022B 

1 

1 

7121000005 



SX2 

814*5 

1 

72337777^1 << 



SX3 

X3-33B 


73^1^2 



SXM 

X11+B2 

1 

7^1553 



SX5 

A5+B3 

1 

i 

7115110 



SX5 

AM 

1 

1 

75601) 



SX6 

AO-Bil 


756111 



SX6 

-BI+AI! 

1 

( 

] 

76776 



SX7 

B7+B6 

i 

1 

77751 



SX7 

B5-B1 

1 
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8.5 CMU SYMBOLIC MACHINE INSTRUCTIONS 

The Compare/Move Unit (CMU) is a standard CPU hardware component of the CYBER 70 Models 72 and 

1 73, and the CYBER 170 Models 172, 173, 174, 720, and 730. The models 810, 815, 825, 830, 835, 840, 845, 
850, 855, 860, and 990 support compare/move instructions through simulation. These central processor 
instructions are used for moving and comparing data fields that consist of strings of G-bit characters. Data 
fields can span word boundaries and can begin and end at any character position within a word. A data 
field is specified by its length in characters and the location of its leftmost character (according to word 
address and character position). Data fields cannot be in the operating registers nor in ECS. 

Each 60-bit word of a data field contains 10 character positions numbered 0 to 9 from left to right (high 
order to low order). 

COMPASS provides symbolic forms of the four CMU instructions plus a pseudo instruction used to generate 
a descriptor word to be referenced by the indirect move instruction. Of the four instructions, the indirect 
move (IM) instruction is the only one that syntactically resembles other CPU instructions. The other three 
instructions have formats dissimilar to CPU instructions and are generated through COMPASS pseudo 
instructions. All of these instructions must begin at the top of a 60-bit word; COMPASS automatically 
forces upper before each of them unless the location field contains a minus sign. All but IM are 60 bits in 
length. IM is 30 bits, but the hardware requires that the instruction be in the upper half of its word. The 
lower half of the word is not executed. COMPASS automatically forces upper following IM, unless the next 
instruction has a minus sign in its location field. 
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8.5.1 IM - INDIRECT MOVE 


rhe indirect move instruction moves the contents of a data field to another location. It is a 30-bit 
instruction that specifies the address of a descriptor word which, in turn, contains the length and address of 
the data fields. 

The assembler forces upper before and after the IM instruction. 

The descriptor word is fetched from storage location (BjKk. If the data field lengtn is zero, the 
instruction is executed as a pass but the execution time is longer. Otherwise, the contents of the source 
field are moved to the destination field. If the two fields overlap, the results are undefined. The XO 
register is used for intermediate storage during execution of the instruction, and is cleared upon 
completion of the instruction. 


Operation 

Variable 

Description 

Octal Code 

IM 

K 

Move data according to word at K 

4640K 

IM 

BjlK 

Move data according to word at(Bj)+K 

464] K 

IM 

Bj 

Move data according to word at (Bj) 

464j 000000 


8.5.2 MD . INDIRECT MOVE DESCRIPTOR WORD 

The MD pseudo instruction generates a descriptor word for use by the indirect move (IM) instruction. 
Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 

sym 

MD 



sym If present, sym is assigned the value of the location counter after the force upper occurs. It 
becomes the symbolic address of the descriptor word. 

i Absolute address expression specifying the field length in characters (0 through 8191), The 

upper 9 bits (i) are placed in bits 56 through 48 of the descriptor word; the lower 4 bits (i) are 
placed in bits 29 through 26. 

kg An expression specifying the first word address of the source field in CM. 

Cg An absolute expression (0 through 9) specifying the starting character position of the source 

field within the word at location kg. Characters are numbered from left to right, 

kfj An expression specifying the first word address of the destination field in CM. 

c^ An absolute expression (0 through 9) specifying the starting character position of the 

destination field within the word at location k^. 
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Indirect Move Descriptor Word format: 

59 48 30 26 22 18 00 




source 

. |src 

des 

destination 

0 

*12-4 

address 

f3-Och 
_1_ 

ch 

address 


Example: 


Code Generated 




LOCATION 

OPERATION 

VARIABLE COMMENTS 


I 


It 

IB ho 

au760a50uG4G05ua7(j0Q 


nwoRo 

MD 

• 

1 

100] ,3UFF4,ii,BUFFP,5 

1 

4640010665 



• 

• 

1 

owo^n * 

1 


BUFFA is at address 2560j BUFFB is at address 3584. 


8.5.3 DM - DIRECT MOVE 

I The direct move (DM) symbolic instruction generates a CMU instruction that moves the contents of a data 
field to another data field. The machine instruction occi 5 )ies one full word. The instruction includes its 
own data field descriptor. 

The assembler forces upper bef '•e a DM instruction. 

If the data field length is zero, the instruction is executed as a pass, but the execution time is longer. 
Otherwise, the contents of the source field are moved to the destination field. If the two fields overlap, 
the results are undefined. The XO register is used for intermediate storage during execution of the 
instruction and is cleared i 4 )on completion of the instruction. 

Format: 


LOCATION 

OPERATION 

VARIABLE SUBFtELOS 

sym 

DM 



sym If present, sym is assigned the value of the location counter after the force upper occurs. It 
becomes the symbolic address of the instruction word. 

i Absolute address expression specifying the field length in characters (0 through 127). 

An expression specifying the first word address of the source field in CM. 

Cg An absolute expression (0 through 9) specifying the starting character position of the source 
field within the word at location kg. 

An expression specifying the first word address of the destination field in CM. 

c^ An absolute expression (0 through 9) specifying the starting character position of the 

destination field within the word at location Characters are numbered from left to right 
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Octal format of instruction; 


59 51 48 30 26 22 18 00 


465 

i6-4 

source address 

£ 3-0 

src 

ch 

des 

ch 

destination 

address 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 




11 

18 

!20 

46570050007405007000 



DM 

-1 - 

127,BUFFA,0,BUFFB,5 

1 

1 


8.5.4 CC - COMPARE COLLATED 

The compare collated (CC) symbolic instruction generates a CMU instruction that compares the contents | 
of two data fields, one character at a time, from left to right, until a pair of corresponding characters is 
found to have unequal collating values or until the data fields are exhausted. It is a 60-bit instruction that 
occupies one full word. It cannot be split between two words. The instruction includes its own data field 
descriptor. Register AO contains the first word address of a table in storage that contains the collating 
values to be used in comparing characters. The result of the comparison is placed in register XO. 

The first word address of the collating table is obtained from register AO, The contents of the data fields 
are compared from left to right, one character at a time from each field, until two unequal characters are 
found. The collating value of each character is obtained from the collating table. If these values are 
equal, the compare continues until another character pair is unequal or until all characters have been 
comp^ed. If the collating values are unequal, the two data fields are unequal and the field with a larger 
collating value is the greater of the two fields. The collating values are treated as 6-bit unsigned integers. 
Note that two unequal characters could have the same collating value and would compare equal. 

Upon instruction completion, register XO contains a 60-bit signed integer as follows: 

(Field A)>(Field B) (X0)=i-n; (X0)>0 

(Field A)=:(Field B) (X0)=0 

(Field A}<(Field B) (X0)=n-i; (X0)<0 

n is the number of pairs of characters that compared equal. If i =0, then (XO) is 0. 

The format of the collating table for 6-bit characters is: 


(AO) 


(A0)+1 


(A0)+7 


59 53 47 41 35 29 23 17 11 0 
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Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 

sym 

CC 



sym If present, sym is assigned the value of the location counter after the force upper occurs. It 
becomes the symbolic address of the instruction. 

a Absolute address expression specifying the field length in characters (0 through 127). 

I^a An expression specifying the first word address of the first data field in CM. 

Ca An absolute expression specifying the starting character position of the first data field within 

the word at location Characters are numbered from left to right. 

k ]3 An expression specifying the first word address of the second data field in CM. 

Cb An absolute expression (0 through 9) specifying the starting character position of the second 

data field within the word at location Kb- 

Octal format of instruction: 


59 51 48 


30 26 22 18 


00 


466 


i6-4 


first string 
address 


i3“0 


fs 

ch 


ss 

ch 


second string 
address 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 




n 

18 

J 30 

5100003120 

46670050007405007000 



SAO 

CC 

-1- 

1 

TABLE 1 

127,BUFFA,0,BUFFB^5 

1 


8.5.5 CU - COMPARE UNCOLLATED 

I The compare uncollated (CU) symbolic instruction generates a CMU instruction that compares the contents 
of two data fields, one character at a time, from left to right, until a pair of corresponding characters are 
found to have unequal values or until the data fields are exhausted. The machine instruction is a 60-bit 
instruction that occupies one full word and cannot be split between two words. It includes its own data 
field descriptor. The result of the comparison is placed in register XO. 

Execution resembles the CC instruction except that AO and the collating table are not used. Instead, the 
characters are compared directly with each character regarded as a 6-bit unsigned binary integer. 

Register XO is set in the same manner as by the CC instruction. 
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Format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 

sym 

cu 



sym If present, sym is assigned the value of the location counter after the force upper occurs. It 
becomes the symbolic address of the instruction. 

I Absolute address expression (0 through 127) specifying the field length in characters. 

An expression specifying the first word address of the first data field in CM. 

An absolute expression (0 through 9) specifying the starting character position of the first data 
field within the word at location k^. Characters are numbered from left to right. 

k\^ An expression specifying the first word address of the second data field in CM. 

Cb An absolute expression (0 through 9) specifying the starting character position of the second 

data field within the word at location k^* 

Octal format of instruction: 


59 51 

48 

30 26 22 

18 00 

467 

^ 1 first string 
address 

6 1 
^3-0 ch 

5S 

ch 

second string 
address 


Example; 

Code Generated 

46770050007405007000 



LOCATION 

OPERATION 

VARIABLE COMMENTS 



11 

IB ho 



CU 

127,8UFFA, 0,jRUFFa,5 

1 

1 
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PP SYMBOLIC MACHINE INSTRUCTIONS 


9 


The COMPASS assembler recognizes symbolic notation for peripheral processor (PP or PPU) instructions 
For COMPASS to recognize symbolic logic for models 810, 815, 825, 830, 835, 840, 845, 850, 855, 860, 865, 
875, and 990 PP instructions, the NOS programmer must ensure that NOSTEXT is avaUable to the 
assembler,^ When a PPU, CIPPU, or PERIPH pseudo instruction is in the first statement group, the 
assembler identifies each symbolic instruction by name and generates a one word or two word object code 
machine instruction under control of the current origin, location, and position counters. All PP code is 
absolute. Numeric data must be in integer notation. Floating point notation is illegal. 

NOTE 

No special job validation is required to assemble peripheral processor programs, but to be 
executed, such programs require system origin privileges. 


existiog COMPASS programs are not valid for execution on models 810, 815, 825, 830, 
835, 840, 845, 850, 855, 860, 865, 875, and 990. To detect these instructions, the programmer can specify 
S-AIDTEXT in the COMPASS control statement. COMPASS prints a listing of the program, flagging the 
invalidated instructions with a type 0 error. S=AIDTEXT should not be specified if the 8 option is chosen 
for the MACHINE pseudo instruction. 


9.1 MACHINE INSTRUCTION FORMATS (12-BIT MODE) 

An assembled instruction has a 12-bit or 24-bit format. The 12-bit format has a 6-bit operation code f and 
a 6-bit operand d. A PP accomplishes program indexing and manipulates operands in several modes. The 
12-bit and 24-bit instruction formats provide for 6-bit, 12-bit, or 18-bit operands and 6-bit or 12-bit 

addresses. Figures 9-1 and 9-2 illustrate the 12-bit instruction format and the 24-bit instruction format, 
respectively. 


Direct Mode: 

d = memory address of operand 


operation 

code 


Indirect Mode: 


(P) 



d - memory address of the address of the 
operand 


No Address Mode: 

d = 6-bit operand, shift count, or relative 
address 


Othen 

d = special valu^ for example, channel 
designator 


Figure 9-1. PP 12-bit Instruction Format 
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Indexed Mode: 


operation 

code 



/- 

-- 

% 




11 


5 4 


0 

(P) 

L_ 

f 

1 1 

1 1 

1 1 

t i 

d 

1 


11 




0 

(P+1) 

in 


f = operation code (7 bits for 
CCF, CFM, SCF, SFM; 6 bits 
for others) 

d = address of the index for 

modifying the address of the 
operand 

m = base address of the operand 
(d) + m = address of operand 

Constant Mode: 


dm - 18-bit operand 


Othen 

dm = special values; for 

example, d = channel 
designator and m = 12-bit 
address of word count on 
lAM and 0AM instructions 


Figure 9-2* PP 24-bit Instruction Format 


The 24-bit format uses the 12-bit quantity m, which is the contents of the next program address (P + 1), 
with d or the contents of d to form on 18-bit operand or a 12-bit operand address. 

! The central memory access instructions for models 810, 815, 825, 830, 835, 840, 845, 850, 855, 860, 865, 
875, and 990 provide the capabEity of reading and writing central memory wori to and from the PP 
m em ory. 

The R register is a 22-bit register iBed to accomplish address relocation during central memory read and 
write instructions. This relocation occurs only if bit 17 of the A register is set to one. 

When relocation is to be done, the absolute central memory address is formed by appending six zerce to the 
lower end of the contents of the R register and adding to the result bits 0 through 16 of the contents of the 
A register. Figure 9-3 Elustrates this process. 


21 0 

Relocation register with 
6 zero bits concatenated 
plus 

Low order 17 bits of A 
register 


R 


000000 


16 


Figure 9-3. Central Memory Access Instruction Address Relocation 
I (Models 810, 815, 825, 830, 835, 840, 845, 850, 855, 860, 865, 875, and 990) 
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9.1.1 MACHINE INSTRUCTION FORMATS (16-BIT MODE) 


An assembled iristruction has a 12““bit, 16-bit, 24-bit, or 32-bit format. The specific format is determined 
by the use of the Psuedo Ops PERIPH and PPU (12-bit and 24-bit) and CIPPU (i2-bit, 16-bit, 24-bit, and 
32-bit combined). In 16-bit mode, an assembled instruction has a 16-bit or 32-bit format. The operation 
code, f, is 10 bits, and d is a 6-bit operand. In the 32-bit format m is usually treated as a 16-bit operand 
but in constant mode addressing only the lower 12-bits are used. The additions of the character L to the 
COMPASS opcode, where supported, sets the upper-most bit of f. When this bit is not set, the instruction 
is identical to the corresponding 12-bit or 24-bit instruction. When it is set, the instruction uses aP 16-bits 
of a PP word whether it is specified by d,m or a combination of the two. Figures 9-4 and 9-5 illustrate the 
16-bit and 32-bit formats. 


Direct Mode: 

f = lOXX, identifies the instruction 
as CY180 16-bit 

d = memory address of a 16-bit 
operand 

Indirect Mode: 

f = lOXX, identifies the instruction 

15 5 0 ^ CY180 16-bit 

d = memory address of a 16-bit 
operand 


No Address Mode: 

f = identical to CY170 mode 
d = identical to CY170 mode 


Other: 

d = special value; for example, 
channel designator 


Figure 9-4. PP 16-bit Instruction Format 
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Indexed Mode: 


(P) 


(P+l) 


15 5 

0 

f 

d 

15 

0 

m 


f = OOXX; 11 bits for CCF, CFM, 
SCF, SFM; 10 bits for all others 

f = lOXX; identifies the instruction 
as aCYiao PP 

d = address of the index for 

modifying the address of the 
operand? 

m = base address of the operandt? 
(d)tm = address of an operand?? 

Constant Mode: 

dm = 18“bit operand. The upper 4 
bits of m are not used. 

Other: 

dm = special values; for example, 
d “ channel designator and 
m = 16~bit address on AJM, 
IJM, FJM and EJM 
instructions, or d = channel 
designator and m = 16-bit 
address of data buffer on lAM 
and 0AM instructions. 

Special Formats: 

The FNCL instruction will support a 
16-bit m field. However, the f 
portion will still be 0077 B. This 
compensates for a CY180 PP 
hardware difference wherein the 
1077 op code is used to "idle” a PP, 

?The contents of the index operand (d) 
are taken as a 12-bit value if 
f “ OOXX and as a 16-bit value if 
f = lOXX, 

??The contents of m are taken as a 
12-bit value if f = OOXX and as a 
16-bit value if f = lOXX. 


Figure 9-5. PP 32-bit Instruction Format 


9.2 SYMBOLIC NOTATION 

This section describes notation used for coding symbolic PP machine instructions. Instructions are 
described in octal operation code sequence which generally reflects the mode of addressing. 
Instructions unique to a computer system are identified as such. 
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The location field of a symbolic PP machine instruction optionally contains a location symbol. When the 
symbol is present, it is assigned the value of the location counter. 

The operation field of a symbolic PP machine instruction contains a three- or four-character name. 

The variable field contains one or two subfields. Each subfield contains an absolute or relocatable 
expression that reduces to a 6-bit, 12-bit, 16-bit, or 18-bit value. 

Designators used in this section are listed in table 9-1. 

TABLE 9-1. PERIPHERAL PROCESSOR INSTRUCTION DESIGNATORS 


Designator 

Use 

A 

18-bit A register. 

c 

An expression that reduces to an 18-bit operand value. 

d 

A 6-bit operand or operand address expression. This field is 5 
bits long for the SCF, CCF, SFM, and CFM instructions. 

m 

A 12-bit or 16-bit expression value used with d or (d) to form 
an 18—bit operand or an operand address. 

p 

12-bit Program Address register. 

Q 

12-bit Q register. 

r 

An expression that reduces to a 6-bit value (-37 < r < 37 ) 

specifying relative address or shift count. . ~ ® 

R 

22-blt R register. 

() 

Contents of a register or location. 

(0) 

Refers to indirect addressing. 


Generally, the third character of the instruction mnemonic (N, D, M, C, or I) indicates the mode of 
addressing: 

N No operand address reference 
D Direct operand address; d contains operand 
M Memory address m or m + (d) contains operand 
C 18-bit constant 
I Indirect; operand address is (d) 

Some PP instructions can be executed only on specific machine models. Table 9-2 lists each instruction 
and the machine models to which it corresponds. 
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TABLE 9-2. PP INSTRUCTION/MACHINE MODEL CORRESPONDENCE 



Machine Model Number 

Mnemonic 

810, 815, 825, 830, 


171, 172, 173, 174, 175, 

720, 730, 740, 750, and 760^ 



835, 840, 845, 850, 855, 

76 and 7600 

71, 72, 73, and 7 4 1 and 

176 


860, 865, 875, and 990 


6000 Series 


ACN 

X 


X 

X 

ADC 

X 

X 

X 

X 

ADD 

X 

X 

X 

X 

ADDL 

X 




ADI 

X 

X 

X 

X 

ADIL 

X 




ADM 

X 

X 

X 

X 

ADML 

X 




ADN 

X 

X 

X 

X 

AJM 

X 


X 

X 

AOD 

X 

X 

X 

X 

AODL 

X 




AOI 

X 

X 

X 

X 

AOIL 

X 




AOM 

X 

X 

X 

X 

AOML 

X 




CCF 

X 




CFM 

X 




CRD 

X 


X 

X 

CRDL 

X 




CRM 

X 


X 

X 

CRML 

X 




CWD 

X 


X 

X 

CWDL 

X 




CWM 

X 


X 

X 

CWML 

X 




DCN 

X 


X 

X 

EIM 


X 



EJM 

X 


X 

X 

EOM 


X 



ernT 





ESN 


X 



ETNt 





EXN 

X 


X 

X 

FAN 

X 


X 

X 

■' FIM 


X 



FJM 

X 


X 

X 

FNC 

X 


X 

X 

FOM 


X 



FCJM 

X 
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TABLE 9-2. PP INSTRUCTION/MACHINE MODEL CORRESPONDENCE (Contd) 



Machine Model Number 

Mnemonic 

Code 

810, 815, 825, 830, 

835, 840, 845, 850, 855, 
860, 865, 875, and 990 

76 and 7600 

171, 172, 173, 174, 175, 

720, 730, 740, 750, and 760; 
71, 72, 73, and 74; and 

6000 Series 

176 

FSJM 

X 




lAM 

X 

X 

X 

X 

lAPM 

X 




IAN 

X 

X 

X 

X 

IJM 

X 


X 

X 

INPN 

X 




IRM 


X 



LCN 

X 

X 

X 

X 

LDC 

X 

X 

X 

X 

LDD 

X 

X 

X 

X 

LDDL 

X 




LDI 

X 

X 

X 

X 

LDIL 

X 




LDM 

X 

X 

X 

X 

LDML 

X 




IDN 

X 

X 

X 

X 

LJM 

X 

X 

X 

X 

LMC 

X 

X 

X 

X 

LMD 

X 

X 

X 

X 

LMDL 

X 




LMI 

X 

X 

X 

X 

LMIL 

X 




LMM 

X 

X 

X 

X 

LMML 

X 




LMN 

X 

X 

X 

X 

LPC 

X 

X 

X 

X 

LPDL 

X 




LPIL 

X 




LPML 

X 




LPN 

X 

X 

X 

X 

LRD 

X 




MAN 

X 


xtt 

X 

MJN 

X 

X 

X 

X 

MXN 


X 



NIM 


X 



NJN 

X 

X 

X 

X 

NOM 


X 



0AM 

X 

X 

X 

X 

OAPM 

X 




OAN 

X 

X 

X 

X 

ORM 


X 



PJN 

X 

X 

X 

X 

PSN 

X 

X 

X 

X 

RAD 

X 

X 

X 

X 

RADL 

X 
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TABLE 9-2. PP INSTRUCTION/MACHINE MODEL CORRESPONDENCE (Contd) 




Mnemonic 

Code 

810, 815, 825, 830, 

1 835, 840, 845, 850, 855, 
860, 865, 875, and 990 

RAI 

X 

1 RAIL 

X 

1 RAM 

X 

RAML 

X 


X 


X 

RJM 

RPN 

X 

SBD 

X 

SBDL 

X 

SB! 

X 

SBIL 

X 

SBM 

X 

SBML 

X 

SBN 

X 

SCF 

X 

SCN 

X 

SFM 

X 

SOD 

X 

SODL 

X 

SHN 

X 

SOI 

X 

SOIL 

X 

SOM 

X 

SGML 

X 

SRD 

X 

STD ' 

X 

STDL 

X 

STI 

X 

STIL 

X 

STM 1 

X 

STML 

X 

UJN ' 

X 

ZJN 

X 

t6416 only. 

t1*Not supported for 6000 Series. 


Machine Model Number 


76 and 7600 


171, 172, 173, 174, 175, 
720, 730, 740, 750, and 760; 
71, 72, 73, and 7 4; and 
6000 Series 


176 


X 

X 


X 

X 


X 

X 

X 

X 


X 

X 


X 

X 

X 

X 


X 

X 


X 

X 

X 


X 

X 

X 

X 


X 

X 


X 

X 

X 

X 


X 

X 
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Some of the instructions provide similar functions using different modes of addressing. They can be 
grouped according to function as shown below: 


Function 


Description 


Data The following instructions either load data into the A register or 

transmission store data from it. A load instruction loads a 6*“bits 12-bit, 16-bit, 

or 18“bit value as indicated by the instruction; any remaining upper bits of A are 
zeroed, except for the LCN instruction, for which remaining bits are set to one. 

A store instruction stores the lower 12 bit, or 16 bits of the A register contents Into a 
memory location indicated by the instruction. 


The contents of A are not altered. 


Instruction 

Octal Code 

Instruction 

Octal Code 

LDN 

14 

STM 

54 

LCN 

15 

LDDL 

1030 

LDC 

20 

STDL 

1034 

LDD 

30 

LDIL 

1040 

STD 

34 

STIL 

1044 

LDI 

40 

LDML 

1050 

STI 

44 

ST ML 

1054 

LDM 

50 




Arithmetic A PP arithmetic instruction adds or subtracts a 6-bit, 12-bit, 16-bit, or 18-bit 

quantity from the contents of the A register and enters the result in A. 


Instruction 

Octal Code 

Instruction 

Octal Code 

ADN 

16 

SBM 

52 

SBN 

17 

ADDL 

1031 

ADC 

21 

SBDL 

1032 

ADD 

31 

ADIL 

1041 

SBD 

32 

SBIL 

1042 

ADI 

41 

ADML 

1051 

SBI 

42 

SB ML 

1052 

ADM 

51 




Logical A logical instruction forms a logical value in A using the contents of A as one of the 

I operands and a 6-bit, 12-bit, 16-bit, or 18-bit value indicated by the instruction as 

the second operand. When the second operand is fewer than 18 bits, the remaining 
upper bits of A are unaltered, except for the LPN instruction for which the upper 12 
bits are zeroed. 

Formation of a logical difference is equivalent to setting each bit in A that is unlike 
the corresponding bit in the second operand. For example: 

Initial (A) =0101 

Operand = 1100 

Final (A) = 1001 

Formation of a logical product is equivalent to setting a bit in A when the original 
setting of the bit in A and the corresponding bit in the second operand are both ones. 
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For example: 

Initial (A) = 0101 

Operand = 1100 

Final (A) = 0100 

A selective clear sets a bit zero in the A register wherever a bit is set in the second 
operand. For example: 

Initial (A) = 0101 

Operand = 1100 

Final (A) = 0001 

Logical instructions include the following: 

Instruction Octal Code Instruction Octal Code 


LMN 

11 

LMM 

53 

LPN 

12 

LPDL 

1022 

SCN 

13 

LPIL 

1023 

LPC 

22 

LPML 

1024 

LMC 

23 

LMDL 

1033 

LMD 

33 

LMIL 

1043 

LMI 

43 

LMML 

1053 


Replace A replace instruction performs an arithmetic operation and returns the results to 

the A register and the memory location from which one operand was obtained. The 
lower 12 bits or 16 bits of the result replaces the operand obtained from a memory | 
location. Replace instructions include the following 


Instruction 

Octal Code 

Instruction 

Octal Code 

RAD 

35 

RADL 

1035 

AOD 

36 

AODL 

1036 

SOD 

37 

SODL 

1037 

RAI 

45 

RAIL 

1045 

A 01 

46 

AOIL 

1046 

SOI 

47 

SOIL 

1047 

RAM 

55 

RAML 

1055 

AOM 

56 

AO ML 

1056 

SOM 

57 

SO ML 

1057 


9.2.1 BRANCH INSTRUCTIONS 

For branch instructions, the r subfield is a numeric value that indicates the number of locations to be 
jumped (maximum 31). When r is positive (01 through 37g), the jump is forward r locations. When r is 
negative (-TGg through - 403 ), the jump is backward TYg-r locations. In the following tests, negative 
zero ( 777777 ) is nonzero. For conditional instructions, when the test condition is true, the jump takes 
place. When the condition is not met, execution continues with the next instruction. 

NOTE 

The jump count must not be 00 or 77. If it is, execution 
loops on the jump instruction. 
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The J option of the PPU instruction and the PERIPH instruction (chapter 4) cause the value of the location 
counter to be subtracted from the value of the symbolic address (tag) before it is placed in the d field of 
the object code instruction. 

Format: 


Operation 

Variable 

Description 


Octal Code 

LJM 

m,d 

Long jump to ni^(cl); if d - 0, m is not 
modified 


01 dm 

RJM 

m, d 

Return jump to m’r(d); Store P-5-2 at m-^ (d) 
and jump to m-^(d)-^l. 

24 or 

32 bits 

02 dm 

UJN 

r+ 

Unconditional jump to P_r locations 

12 bits 

03d 

UJN 

tag 

Unconditional jump to tag 

12 bits 

03d 

ZJN 


Zei’o jump; jump to Pir locations if 
(A) = 0 

12 bits 

04d 

ZJN 

tag 

Zero jump to tag 

12 bits 

04d 

NJN 

rt 

Nonzero jump; jump to P-5 r locations if 
(A) 7^ 0 

12 bits 

0 ,ld 

NJN 

tag 

Nonzero jump to tag 

12 bits 

05d 

PJN 

rt 

Positive jump; jump to P-r locations if 
(A)>0 

12 bits 

OGd 

PJN 

tag 

Positive jump to tag 

12 bits 

OGd 

MJN 

rt 

IMinus jump; jump to P^r locations if 
(A)<0 

12 bits 

07d 

MJN 

tag 

Minus jump to tag 

12 bits 

07d 

^If PPU J or PERIPH J option has been selected, r is not valid. The contents of the variable 
field must be a symbolic address (tag). 
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Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


ii 

IB 

ho 

0100 1:^62 



LJM 

START 

— ^ - 

0271 GOOD 



PJH 

0,nTO 

1 

1 

0171 



UJM 

TAGl-^ 

\ 

oun4 



7JN 

4-4 

1 

1 

0^525 



NJN 

TAGl 

1 

1 

06f)7 



PJM 

TAG?-^ 

1 

0726 



MJN 

TAG^* 

1 


In the above example, the LJM instruction is at address 00140 . TAGl is address 00123 , TAG2 has a 
value of 130 , TAG3 has a value of 263 , and TAG4 has a value of 263 . 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


t 


11 

18 

ho 




PPU 

J 

1 

1 

( 

0347 



UJN 

TAGl 

1 

1 

0404 



7JN ' 

TAG^ 

1 In this example, the UJN is at 

1 address 0040, TAGl is address 

0556 



NJN 

TAG2+in 

1 0010, TAG2 is 0011, TAG3 is 

1 address 0045, and TAG4 is 

0602 



PJM 

•l+TflG4 

1 address 0046. 

0743 



MJN 

TAGl 

1 


9,2.2 SHIFT INSTRUCTION 

The SHN instruction shifts the contents of the A register right or left r places. If r is positive +1 to +31), 
the shift is left circular r places; if r is negative (-31 to -1), the shift is end off r places to the right with no 
sign extension. No shift takes place when r is + 0. The assembler places the value of the r expression in 
the d field. If -31>r>31, the assembler generates an address error. 

Format; 


Operation 

Variable 

Description 

Size 

Octal Code 

SHN 

1 

r 

Shift (A) by + (left) or - (right) r bits 

12 bits 

lOd 
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Example: 

1, Shift contents of A left circular 6 places 


Code Generated 


LOCATION 

OPERATION 

VARIABLE COMMENTS 

1006 

Shift contents of A right e 

Code Generated 

6 

1071 

1 


11 

18 |3D 

nc 

i off 6 place 

SHN 

S 

6 ' 


LOCATION 

OPERATION 

VARIABLE COMMENTS 

1 


II 

16 |30 


SCNT 

SET. 

SHN 

6 • 

-SCNT j 


9.2.3 NO ADDRESS MODE INSTRUCTIONS 


In this mode, during instruction execution, the contents of the d field are interpreted as a 6-bit positive 
operand. This mode eliminates the need for storing many constants in memory. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

LMN 

d 

Logical difference {A)-d^A 

12 bits 

lid 

LPN 

d 

Logical product (A)*d-^A 

12 bits 

12 d 

SCN 

d 

Selective clear (A) 

12 bits 

13d 

LDN 

d 

Load d-^A 

12 bits 

14d 

LCN 

d 

Load complement d-^A 

12 bits 

15d 

ADN 

d 

Add (A)+d-^A 

12 bits 

16d 

SEN 

d 

Subtract (A)-d-^A 

12 bits 

17d 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


11 

IB 

Uo 






1112 



LMN 

I2n 

1 

1 

1207 



LPN 

7 

1 

1 

13?1 


1 

SCN 

210 

1 

1 

15 

1415 


QO 

SFT 

LHN 

150 

flA 

1 

1 

1514 



LCN 

AA-1 

1 

1601 



AON 

1 

1 

1702 



SRN 

7 

j 

1 
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9.2.4 CONSTANT MODE INSTRUCTIONS 


In this mode, during instruction execution, the contents of the d and m fields are taken directly as an 
operand. This mode also eliminates the need for storing many constants. The assembler reduces absolute 
or relocatable expression c to an 18-bit value and stores the upper six bits in d and the lower 12 bits in m. 

Format; 


Operation 

Variable 

Description 

Size 

Octal Code 

LDC 

c 

Load c -^A 

24 bits 

20 dm 

ADC 

c 

Add (A)-fc —A 

24 bits 

21 dni 

LPC 

c 

Logical product (A) *c -^A 

24 bits 

22 clm 

LMC 

c 

Logical difference (A)-c-nA 

24 bits 

23dm 


Example: 


Code Generated 


LOCATION 

OPERATION 1 

VARIABLE 

COMMENTS 



1 


M 

18 

|30 

2Q7D 

7D7D 



Lnr 

7n7n7riq 

-i- 

1 

1 


Q 


V/'L 

— 

G 

1 

1 

1 

?177 

7776 



Anr 

VAL-t 

I 

1 

2?07 

0707 



LPC 

n7P7p7n 

1 

1 


7Q707 




Q7n7p74 

1 

1 

2 7 07 

07G7 



LMC 

1 MA^k 

1 

1 


9.2.5 NO OPERATION INSTRUCTION 

The PSN instruction specifies that no operation is to be performed. It provides a means of padding a 
program. 

For the models 810, 815, 825, 830, 835, 840, 845, 850, 855, 860, 865, 875, and 990 the variable field of the | 
PSN instruction must be blank. Otherwise it is interpreted as an LRD instruction. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

PSN 


No operation (Pass) 

12 bits 

2400 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


11 

IB 

1 30 





1 - 

24C0 



PSN 

- t 

* 1 
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other octal operation codes (not generated by COMPASS) that act as pass instructions are: 


CYBER 180 Series; CYBER 170 Series; CYBER 70 



CYBER 70 Models 71, 72, 73, and 74; and 6000 Series 

Model 76 and 7600 

00 


25 

25 

(2500 for Models 810, 815, 825, 830, 835, 840, 845, 850, 855, 

860, 865, 875, and 990) 

27 

2700 

(Models 810, 815, 825, 830, 835, 840, 845, 850, 855, 860, 865, 

875, and 990 only) 

76 


9.2.6 LOAD AND STORE R REGISTER INSTRUCTIONS 

The LRD instruction loads the R register* Bits 0 through 11 of the R register are loaded from d+1; bits 12 
through 21 of R are loaded from bits 0 through 9 of d. 

SRD stores the contents of the R register into d and d+l. Bits 0 through 11 of R are stored into d+1; bits 
12 through 21 of R ore stored into bits 0 through 9 of d. 

If the variable field is set to zero, LRD and SRD execute as pass instructions. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

LRD 

d 

Load (R) from d and d+1 

12 bits 

24d 

SRD 

d 

Store (R) into d and d+1 

12 bits 

25d 


Example: 


Code Generated 


LOCATION 

OPERAUON 

variable 

COMMENTS 

1 


II 

IB 

30 

2400 



LRD 


PASS INSTRUCTION 

2500 



SRD 


PASS INSTRUCTION 

2412 



LRD 

12B 


2512 



SRD 

12B 
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9.2.7 EXCHANGE JUMP INSTRUCTIONS 


The EXN instruction transmits an 18-bit (absolute) address from the A register to the CPU with a signal 
notifying the CPU to execute an exchange jump. The address in A is the starting location of the 16-word 
exchange package which contains information about the CPU program to be executed. The 18-bit initial 
address must be entered in A before the EXN instruction is executed. The CPU replaces the file with 
similar information from the interrupted CPU program. The PP is not interrupted. The EXN instruction 
does not affect the monitor flag bit. 


The MXN instruction conditionally exchange jumps to the CPU and initiates CPU monitor activity. If the 
monitor flag bit is clear, this instruction sets the flag and initiates the exchange. If the monitor flag bit is 
set, this instruction acts as a pass instruction. The starting address for tliis exchange is the 18-bit address 
in the PP A register. This address must be entered in A before the MXN instruction is executed. 


Execution of MAN resembles MXN- However, the exchange paelcage address is taken from the 18-bit 
Monitor Address (MA) register in CPU d, rather than from the PP A register. 


In a system with dual central processors, d can be 0 or 1 and specifies which CPU the exchange jump will 
interrupt. In sin^e processor systems, this value is not interpreted. 


Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

EXN 

d 

Exchange jump CPU d to (A) 

12 bits 


MXN 

d 

Monitor exchange jump CPU d to (A) 

12 bits 


MAN 

d 

Monitor exchange jump CPU d to (MA) 

12 bits 



Example: 

Code Generated 

2601 

2610 

2623 



LOCATION 


VARIABLE 

COMMENTS 

1 


" 

IB 

|3Q 







EXN 

1 

1 

1 



MXM 

c 

1 

1 ■ 



,1'\N 

7 

1 

! 

1 
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9.2.7.1 INTERRUPT PROCESSOR 


The INPN instruction transmits an interrupt signal for the CPU on the memory port specified by d. The 
interrupt signal is transmitted by the memory port interface provided to transmit interrupts between 
processors. This interrupt signal causes the External Interrupt bit to be set in the CPU Monitor Condition 
Register. Execution of this instruction is delayed until all previous central memory accesses made by the 
interrupting processor are complete. 


Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

INPN 

d 

Interrupt d 

i 

16-bits 

_ 



9.2.8 READ PROGRAM ADDRESS INSTRUCTION 

This instruction transfers the contents of the CPU P register to the PP A register; this allows the PP to 
determine whether the CPU is in execution. In a dual central processor system, the lowest order bit of the 
instruction format specifies which CPU P register is to be examined. This bit is not interpreted for a 
sin^e central processor system. 


Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

RPN 

d 

Read program address CPU cl A 

12 bits 

27 Od 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


I 


n 

IB 

ho 





. 

27C0 



RPM 

I 

1 


I 
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For the 6000 and CYBER 70 Series, the largest value that (P) can be is 17 bits. An ECS transfer is in 
progress when bit 17 of the A register is set. For the CYBER 170 series, the P register is 18 bits. 

I The RPN instruction is not valid for the models 810, 815, 825, 830, 835, 840, 845, 850, 855, 860, and 990. 
The 2700 octal code executes as a pass instruction. 


9.2.9 6416 PP INSTRUCTIONS 


COMPASS assembles the following instructions for execution on a 6416 computer system only. The ETN 
instruction initiates memory transfer operations by transmitting an 18-bit address from the PP A register 
to the 6416 16K memory. This address points to a word having the following format: 


59 


35 


17 


XO 


AO 


Shirting A t Id res s 
in ECS 


Shirting Address 
in 16 K Memory 


-V- 

Won! Count 


Expression d of this instruction specifies the transfer,to be performed: 
e If d is 0, K words are transferred from ECS to 16K memory. 

© If d is 1, K words are transferred from 16K memory to ECS. 

Note that addresses contained in the word are absolute addresses. Operating systems may require 
relocation (adding RA to an address) and field length testing, e.g., Is address + RA>FL? The Exchange 
Jump package contains RA and FL values for central memory and for extended memory. The 6416 has no 
hardware for automatic relocation and field length testing; it is therefore incumbent upon the program to 
perform these functions whenever required by on operating system. 

The ERN instruction examines the status of the data trunk between 16K memory and the extended core 
coupler. If the data trunk is busy (a transfer is in progress), a 1 is placed in the most significant bit 
position of the A register. If the trunk is free (not busy), the A register remains cleared. The d portion of 
this instruction is ignored. 

After execution of this instruction the program would typically test the A register for a sign before 
executing an instruction that initiates an ECS operation. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

ETN 

d 

Extended core transfer 

12 bits 

2G0d 

ERN 

d 

Read extended core couplei* status 

12 bits 

27 Od 


Example: 


Code Generated 


LOCATION 

OPERATION 

variable 

COMMENTS 


t 


II 

IQ 

ho 

2600 



F tn 


1 

?7CD 





1 
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9.2.10 DIRECT ADDRESS MODE INSTRUCTIONS 


In this mode, during instruction execution, the contents of the d field specify the address of the operand. 
During assembly, the assembler reduces absolute or relocatable expression d to a 6-bit value that specifies 
one of the first lOOg addresses in memory (0000 through 0077g). During instruction execution, (d) is 
treated as a positive 12-bit quantity. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

LDD 

d 

Load (d)-*A 

12 bits 

30d 

ADD 

d 

Add (A) + (d)—A 

12 bits 

31d 

SBD 

d 

Subtract (A) - (d)^A 

12 bits 

3 2d 

LMD 

d 

Logical difference (A) and (d)-^A 

12 bits 

33d 

STD 

d 

Store (A)-^d 

12 bits 

34d 

RAD 

d 

Replace add (d) + (A)—^d and A 

12 bits 

35d 

AOD 

d 

Replace add (d) + 1—d and A 

12 bits 

36d 

SOD 

d 

Replace subtract one (d) - !-► d and A 

12 bits 

37d 

LPDL 

d 

Logical product of (A) ♦ d-*^A 

16 bits 

1022d 

LDDL 

d 

Load (d)*-^A 

16 bits 

lQ30d 

ADDL 

d 

Add(A) +(d)—A 

16 bits 

1031d 

SBDL 

d 

Subtract (A) - (d) -*-A 

16 bits 

1032d 

LMDL 

d 

Logical difference (A) and (d)—A 

16 bits 

1033d 

STDL 

d 

Store (A)-*-d 

16 bits 

1034d 

RADL 

d 

Replace add (d) + (A)—d and A 

16 bits 

1035d 

AODL 

d 

Replace add (d) + 1-^-d and A 

16 bits 

1036d 

SODL 

d 

Replace subtract one (d) - 1-^d and A 

16 bits 

_1 

1037d 
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Example: 


Code Generated 


301 ? 

3103 

M?7 

3401 

35^5 

361 ? 

3713 



9.2.11 INDIRECT ADDRESS MODE INSTRUCTIONS 

In this mode, during instruction execution, d specifies an address, the contents of which specify the address 
of the desired operand. Thus, d specifies the operand address indirectly. 


During assembly, the assembler reduces absolute or relocatable expression d to a 6 -bit value that specifies 
one of the first IOO 3 addresses in memory (0000 through OO 773 ). 


On the 7600 (or CYBER 70 Model 76), the address formed permits referencing of memory locations 0000 
through 77763 . Location 7777g cannot be referenced. 


On a 6000 Series Computer System (as well as CYBER 180 Series or CYBER 170 Series or CYBER 70 Model 
71, 72, 73, or 74) PP, the address formed in indirect address mode permits referencing of aH memory 
locations. 
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Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

LDI 

d 

Load ((d))-oA 

12 bits 

40d 

ADI 

d 

Add (A) + ((d))—A 

12 bits 

41d 

SBI 

d 

Subtract (A) - ((d)) -^A 

12 bits 

42d 

LMI 

d 

Logical difference (A) - ((d)) —A 

12 bits 

43d 

STI 

d 

Store (A) — (d) 

12 bits 

44d 

RAI 

d 

Replace add ((d)) + (A) — (d) and A 

12 bits 

45d 

A 01 

d 

Replace add one ((d)) + 1 — (d) and A 

12 bits 

46d 

SOI 

d 

Replace subtract one ((d)) - 1 (d) and A 

12 bits 

47d 

LPIL 

d 

Logical product of (A) * d—A 

16 bits 

1023d 

LDIL 

d 

Load ((d))—A 

16 bits 

1040d 

ADIL 

d 

Add (A) + ((d))—A 

16 bits 

1041d 

SBIL 

d 

Subtract (A) - ((d))—A 

16 bits 

1042d 

LMIL 

d 

Lopcal difference (A) - ((d))—A 

16 bits 

1043d 

STIL 

d 

Store (A) — (d) 

16 bits 

1044d 

RAIL 

d 

Replace add ((d)) + (A) — (d) and A 

16 bits 

1045d 

AOIL 

d 

Replace add one ((d)) +1 — (d) and A 

16 bits 

1046d 

jsOIL 

d 

Replace subtract one ((d)) - 1 — (d) and A 

16 bits 

1047d 


Example: 


Code Generated 

1 



VARIABLE 

COMMENTS 




11 

ia 

ho 

4012 



LPT 

TAGl 

—1----- 

1 

4107 



AQT 

TA62-ia 

j 

4240 




4 1 n 

1 

1 

47?7 



LMT 


1 

1 

4401 




1 

1 

1 

455S 



PAT 


1 

1 

I 

4612 




TAGl 

j 

1 

1 

4713 



SOT 

TAG? 

i 

1 
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9,2.12 INDEXED DIRECT ADDRESS MODE INSTRUCTIONS 


In this mode, during instruction execution, The value formed by m + (d) is used as the address of the 
operand. During assembly, the assembler reduces absolute or relocatable expression d to a 6-bit value that 
specifies one of the first lOOg addresses in memory (0000 through OOTTg). The value of absolute or 
relocatable expression m is a base address. 


NOTE 

For all PPs except CYBER 180 model 990 and certain 
model 840, 850, and 860 systems, the address formed in 
indexed addressing permits referencing of all memory 
locations but one (0000 through 7776g), Although m 
and/or (d) can have a value of 7777 g, the computer 
system does not permit m (d) to reference address 
77778 . 


When in indexed direct address mode, if d is nonzero the contents of address d are added to m to produce a 
12-bit operand address (indexed addressing). If d is zero, m is taken as the operand address. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

LDM 

m,d 

Load (m + (d))—A 

24 bits 

50dm 

ADM 

m,d 

Add (A) + (m + (d))-“A 

24 bits 

51dm 

SBM 

m,d 

Subtract (A) - (m + (d))-^A 

24 bits 

52dm 

LMM 

m,d 

Logical difference (A) - (m + (d))^A 

24 bits 

53dm 

STM 

m,d 

Store (A) ^ m + (d) 

24 bits 

54dm 

RAM 

m,d 

Replace add (m + (d)) + (A) — m + (d) and A 

24 bits 

55dm 

AOM 

m,d 

Replace add one (m + (d)) + l m + (d) and A 

24 bits 

56dm 

SOM 

m,d 

Replace subtract one (m + (d)) - 1 -- m + (d) and A 

24 bits 

57dm 

LPML 

m,d 

Logical product (m + (d))“^A 

32 bits 

1024dm 

LDML 

m,d 

Load (m + (d))“^A 

32 bits 

1050dm 

AD ML 

m,d 

Add (A) + (m + (d)) -♦"A 

32 bits 

1051dm 

SB ML 

m,d 

Subtract (A) - (m + (d))"^A 

32 bits 

1052dm 

LMML 

m,d 

Logical difference (A) - (m + (d))-**A 

32 bits 

1053dm 

STML 

m,d 

Store (A) -*• m + (d) 

32 bits 

1054dm 

RAML 

m,d 

Replace add (m + (d)) + (A) ^ m + (d) and A 

1 

32 bits 

1055dm 

AOML 

m,d 

1 

Replace add one (m + (d)) + 1 ^ m + (d) and A 

^ 32 bits 

1056dm 

SGML 

m,d 

Replace subtract one (m + (d)) - 1 ^ m (d) and A 

32 bits 

1057dm 
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Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE COMMENTS 

I 


It 

18 Uo 

5077 0203 



LDM 

-1- 

TAGb,77B 1 

t 

5106 0202 



AOH 

TAG5,b [ 

5200 0202 



SUM 

1 

TAG5 ; 

5315 7000 



LMM 

7 0003,15B 1 

5410 0272 



bTM 

1 

T AG5.70B,TAG1-2 

1 

5500 0342 



RAH 

14O0+IAG5,D 

5600 0173 



AOM 

1 

-lOBtTAGb 1 

1 1 

5712 0203 



S>0H 1 

TAGGfIAGI ' 

' r 


9.2.13 CENTRAL READ/WRITE INSTRUCTIONS (12-BIT MODE) 

The CRD instruction transfers a 60-bit word from central memory to five consecutive PP locations. The 
18-bit address of the central memory location must be loaded into A prior to executing this instruction. 
(Note that this is an absolute address.) The 60-bit word is disassembled into five 12-bit words beginning at 
the left. Location d receives the first 12-bit word. The remaining 12-bit words go to successive locations. 
The contents of A are not altered. 


The CRM instruction reads a block of 60-bit words from central memory. The contents of location d give 
the block length. The 18-bit address of the first centrd. word must be loaded into A prior to executing this 
instruction. (Note that this is an absolute address.) During the execution of the instruction, the contents 
of P go to processor address 0 and P holds m. Also, the block length (from d) goes to the Q register where 
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it is reduced by one as each central word is processed. The original content of P is restored at the end of 
the instruction. The new contents of P are fetched from word 0. If the read operation overwrote the 
contents of word 0, the restored value of P will be different from the original contents. 

The contents of A are incremented by one to provide the next central memory address after each 60-bit 
word is disassembled and stored. The contents of the Q register are also reduced by one. The block 
transfer is complete when (Q)=0. The block of central memory locations proceeds from address (A) to 
address (A)-Kd)-1. The block of processor memory locations proceeds from address m to m+5(d)-l. 

Each central word is disassembled into five 12-bit words beginning with the high-order 12 bits. The first 
word is stored at processor memory location m. The content of P (which is holding m) is advanced by one 
to provide the next address in the processor memory as each 12-bit word is stored. If P overflows, 
operation continues as P is advanced from 7777g to OOOOg. These locations will be written into as if 
they were consecutive. 

The CWD instruction assembles five successive 12-bit words into a 60-bit word and stores the word in 
central memory. The 18-bit address word designating the central memory location must be in A prior to 
execution of the instruction. (Note that this is an absolute address.) 

Location d holds the first word to be read out of the processor memory. This word appears as the higher 
order 12 bits of the 60-bit word to be stored in central memory. The remaining words are taken from 
successive addresses. 

The CWM instruction assembles a block of 60-bit words and writes them in central memory. The content 
of location d gives the number of 60-bit words. The content of the A register gives the beginning central 
memory address. (Note that this is an absolute address.) During the execution of this instruction (P) goes 
to processor address 0, and P holds m. Also, (d) goes to the Q register, where it is reduced by one as each 
central word is assembled. The original content of P is restored at the end of the instruction. 

The content of P (the m portion of the instruction) gives the address of the first word to be read out of the 
processor memory. This word appears as the higher order 12 bits of the first 60-bit word to be stored in 
central memory. 

The content of P is advanced by one to provide the next address in the processor memory as each 12-bit 
word is read. If P overflows, operation continues as P is advanced from 7777g to OOOOg. These 
locations will be read from as if they were consecutive. 

(A) is advanced by one to provide the next central memory address after each 60-bit word is assembled. 
Also, Q is reduced by one. The block transfer is complete when (Q)=0. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

CRD 

d 

Central read from (A) to d 

12 bits 

60d 

CRM 

m,d^ 

Central read (d) CM words beginning 
at CM ( A)-*- PP m 

24 bits 

61dm 

CWD 

d 

Central write from d to (A) 

12 bits 

62d 

CWM 

m,d^ 

Central write (d) words beginning 
at PP m-^CM (A) 

24 bits 

6 :idni 

t 

Expression d is required. 
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Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


11 

ts 

|3D 

- 1 ---- 

6015 



CRO 

15P 

-f- 

1 

6125 0012 



CRH 

TAG! ,25B 

1 

1 

6232 



CWD 

32R 

1 

6350 0012 



CWM 

TAGl ,5QB 

1 

— 





1 


9.2.14 CENTRAL READ/WRITE INSTRUCTIONS (16-BIT MODE) 

The CRDL instruction transfers a 64-bit word from central memory to four consecutive PP locations. The 
absolute address of the central memory word to be transferred must be loaded in the A and R registers 
prior to executing this instruction. The 64-bit word is disassembled into four 16-bit words beginning at the 
left. Location d receives the first 16-bit word. The remaining 16-bit words go to successive locations. 

The contents of the A and R registers are not altered. 

The CRML instruction reads a block of 64-bit words from central memory. The contents of location d give 
the block length. The absolute address of the first central memory word of the block must be loaded into 
the A and R registers prior to executing this instruction. During the execution of this instruction the 
contents of P go to processor address 0, and P holds m. Also, the block length (from d) goes to the Q 
register where it is reduced by one as each central word is processed. The original contents of P are 
restored at the end of the instruction. The new contents of P are fetched from word 0. If the read 
operation overwrote the contents of word 0, the restored value of P will be different from the original 
contents of P. 

The contents of the A register are incremented by one to provide the next central memory address after 
each 64-bit word is disassembled and stored (note that the R register is not automatically incremented). 
The contents of the Q register are also reduced by one. The block transfer is complete when (Q) = 0. The 
block of central memory locations proceeds from address (A) (R) to address (A) + (R) + (d) - 1, The block 

of PP memory locations proceeds from address m to address m + 4 (d)- 1. 

The R register is not automatically updated, which places a limitation on the central memory word count 
and address ranges that can be used with this instruction. A central memory transfer must be within any 
given 131,072 64-bit word block from address (R) + 0 to (R) + 377777 (octal). The A register is used to 
establish the address of the next central memory word, and the upper-most bit of A enables the addition of 
(R) + (A) to form the address. If (A) are incremented through 777777 to 0, the addition of (R) to (A) for the 
address is disabled. This may result in the transfer of the wrong central memory words. 

Each central word is disassembled into four 16-bit words beginning with the high-order bits. The first word 
is stored at PP location m. The content of P (which is holding m) is advanced by one to provide the next 
address in PP memory as each 16-bit word is stored. If P overflows, the operation continues as P is 
advanced through the last-word-address in PP memory to 0000. The last-word-address in PP memory and 
address 0000 are treated as if they are consecutive. 

The CWDL instruction transfers four consecutive PP memory words to one central memory word. The 
address of the first PP word is specified by d. The address of the central memory word is specified by the 
A and R registers. 


60492600 M 


9-19 • 











The CWML instruction assembles a block of 64-bit words and writes them in central memory. The content 
of location d gives the number of 64-bit words. The content of the A and R registers give the beginning 
absolute central memory address (refer to transfer restrictions above). During execution of this instruction 
(P) goes to PP location 0 and P holds m. Also, (d) goes to Q where it is reduced by one as each central word 
is assembled. The original content of P is restored at the end of the instruction. 

The content of P (the m portion of the instruction) gives the address of the first word to be read out of PP 
memory. This word appears as the high-order 16 bits of the first 64-bit word to be stored in central 
mem ory. 

The content of P is advanced by one to provide the next address in PP memory as each 16-bit word is read. 
If P overflows, the operation continues as P is advanced through the last-word-address of PP memory to 
address 0000. These locations will be read as if they were consecutive, 

(A) is advanced by one to provide the next central memory address after each 64-bit word is assembled. 
Also, Q is reduced by one. The block transfers is complete when (Q) = 0. 

The RDCL instruction performs a logical "AND‘^ function between four consecutive PP memory words and 
one central memory word with the result replacing the central memory word. The original contents of the 
central memory word replaces the four PP memory words. The address of the first PP word is specified by 
d. The address of the central memory word is specified by the A register. 

The RDSL instruction performs a logical ”OR" function between four consecutive PP memory words and 
one central memory word with the result replacing the central memory word. The original contents of the 
centrfiG. memory word replaces the four PP memory words. The address of the first PP word is specified by 
d. The address of the central memory word is specified by the A register. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

CRDL 

d 

Central read from (A) to d. 

16 bits 

1060d 

CRML 

m,d 

Central read (d) CM words beginning at 
CM{A)toPPm. 

32 bits 

1061dm 

CWDL 

d 

Central write from d to (A). 

16 bits 

1062d 

CWML 

m,d 

Central write (d) words from PP m to 

CM (A). 

32 bits 

1063dm 

RDCL 

d 

Central read and dear lock from d to (A). 

16 bits 

lOOld 

RDSL 

d 

Central read and set lock from d to (A). 

16 bits 

lOOOd 
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9.2.15 I/O BRANCH INSTRUCTIONS 


I 


The following instructions are conditional long jump instructions, each of which tests for a condition on 
channd d. When the condition is true, the jump to address m takes place. When the condition is not met, 
execution continues with the next instruction. The d expression is required. 

For the FJM instruction, an input channel is full when the input equipment has sent a word to the channel 
register and sets the full flag. The channel remains full until the PP accepts the word and clears the flag. 
An output channel remains fuU when a PP sends a word to the channel register and sets the full flag. The 
channel is empty when the output equipment accepts the word and notifies the PP. 

On the models 810, 815, 825, 830, 835, 840, 845, 850, 855, 860, 865, 875,and 990, d must be less than 40g. 


Format: 

Operation 

Variable 

Description 

Size 

Octal Code 

AJM 

m,d 

Jump to m if channel d active 

24 bits 

64clm 

IJM 

m,d 

Jump to m if channel d inactive 

24 bits 

65 dm 

FJM 

m,d 

Jump to ni if channel cl full 

24 bits 

66 dm 

EJM 

m, d 

Jump to m if channel d empty 

24 bits 

G7dm 


Exam^e; 


Code Generated 

6402 OOi? 
65G2 nOl^ 
6604 002^ 
6^04 0026 
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I 9.2.16 I/O TEST AND SET CHANNEL FLAG INSTRUCTIONS 

The SCF instruction branches to the location specified by m if the channel d flag is set; otherwise, it sets 
the channel flag and exits. The programmer can unconditionally set the channel flag by setting m to P+2. 

The CCF instruction clears the flag in the channel specified by d. The m field is required, but not used. 

The SFM instruction branches to the location specified by m if the channel d error flag is set, and clears 
the error flag. 

The CFM instruction branches to the location specified by m if the channel d error flag is dear; otherwise, 
it clears the error flag. 

Format; 


Operation 

Variablet 

Description 

Size 

Octal Codett 

SCF 

m,d 

Branch to m if channel d flag set 

24 bits 

644dm 

CCF 

m,d 

Clear channel d flag 

24 bits 

654dm 

SFM 

m,d 

Branch to m if channel d error flag set 

24 bits 

664dm 

CFM 

m,d 

Branch to m if channel d errot flag clear 

24 bits 

674dm 

FSJM 

m,c 

Jump to m if channel c flag set 

24 bits 

1064X 

FCJM 

m,c 

Jump to m if channel c flag clear 

24 bits 

1065X 

tThe variable d is a 5~bit field containing the channel number. 
ttThe operation code occupies 7 bits. 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


11 

IB 

30 

6445 Q100 



SCF 

100B,5 1 

1 

6545 0100 



CCF 

1 

100B,5 \ 

6645 0100 



SFN 

1 

100B,5 I 

1 

6745 0100 



CFM 

1 

100B,5 1 

1 

6453 0100 



SCF 

1 

100B,13B 1 

1 

6553 0100 



CCF 

1 

100B,13B 1 

1 

6653 0100 



SFM 

1 

100B,13B 1 

1 

6753 0100 



CFM 

! 

100B,13B 1 ■ 

1 
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9.2.17 I/O BRANCH INSTRUCTIONS 


The following instructions are conditional long jump instructions, each of which tests a condition on 
channel d. When the condition is true, the jump to address m takes place. When the condition is not met, 
execution continues with the next instruction. These instructions are exclusively 7600 PPU instructions. 
The d expression is required. 

Format; 


Operation 

Variable 

Description 

Size 

Octal Code 

FIM 

m,d 

Jump to m on channel cl input word flag 

24 bits 

COdni 

EIM 

Tn,d 

Jump to m if no input word flag on channel d 

24 bits 

61dm 

IRM 

m,d 

Jump to m on channel d input record flag 

24 bits 

G2cbii 

NIM 

m,d 

Jump to m if no input record flag on 
channel d 

24 bits 

63dm 

FOM 

m, d 

Jump to m on channel d output word flag 

24 bits 

64dm 

EOM 

m, d 

Jump to m if no output word flag on 
channel d 

24 bits 

65 dm 

ORM 

m,d 

Jump to m on channel d outi^ut record flag 

24 bits 

GGcbn 

NOM 

m,d 

Jump to m if no output record flag on 
channel d 

24 bits 

67dm 


Example: 


Code Generated 


lOCATlON 

OPERATION 

VARIABLE COMMENTS 


1 


11 

IB ISQ 





1 

F>no5 




[ 

Bin? 



rv^ 

1 

TAC.'l,? 1 

6 ?ni 



IPM 

^AGFa 1 

4 


CH/JM 

^CT 

u 

b?n4 1*^6^ 



HIM 

TAGBiGHAN ' 

6415 7000 



roM 

70060*150 1 

1 




FOM 

1 

0 1 




O^M 

1 

-1 0 

6765 1366 



NflM 

TAGF ,CHAN+1 [ 
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I 9.2.18 A REGISTER INPUT/OUTPUT INSTRUCTIONS 

The following instructions transfer a word to or from channel d and the lower 12 bits of the A register. 

On the CYBER 70 Model 76 and the 7600, the IAN instruction is not executed until the input channel d 
word flag is set. If the flag is not set when the instruction is read, execution halts until an external signal 
sets the flag. The input channel d record flag does not affect the IAN execution. The IAN instruction 
clears the input channel d word flag and record flag and transmits a resume signal over the input cable 
after the word is entered in the A register. 

On the CYBER 70 Model 76 and the 7600, the OAN instruction is not executed while the output channel d 
word flag is set. If the flag is set, execution stops untU an external resume signal clears the flag. This 
instruction sets the output channel d word flag and transmits a work pulse over the output channel cable. 

On a CYBER 180 Series; a CYBER 170 Series; CYBER 70 Model 71, 72, 73, 74; or 6000 Series machine, 
executing either of these instructions when the channel is inactive causes the peripheral processor to 
become inoperative until some other peripheral processor activates the channel or the system is 
deads tarted, 

I On a CYBER 180 Series, executing either of these instructions causes 16 bits of data to be transferred. 


Format: 


Operation 

Variable 

Description 

Size 

Octnl Code 

IAN 

d 

Input: channel d to A 

12 bits 

70d 

OAN 

d 

Output: (A) to channel d 

12 bits 

72d 


Example: 


Code Generated 

7DQ3 

7204 



LOCATION 

OPERATION 

variable 

COMMENTS 

1 


11 

ie 

t30 







I/iN 


1 



OAN 

CHAN 

1 


1 9.2.19 BLOCK INPUT/OUTPUT INSTRUCTIONS 

The following instructions transfer a block of 12-bit or 16-bit words on channel d to or from a starting PP 
memory location specified by m. The number of words transferred is specified by the contents of the A 
register which is reduced by one as each word is transferred. The operation is completed when (A)“0 or the 
I channel becomes inactive (CYBER 180 Series; CYBER 170 Series; CYBER 70 Models 71, 72, 73, and 74; and 
6000 only). 

On the CYBER 180 Series; the CYBER 170 Series; CYBER 70 Models 71, 72, 73, and 74; and 6000 Series 
machines, the input operation is complete when the contents of A equal 0 or the data channel becomes 
inactive. If the operation is terminated by the channel becoming inactive, the next location in the 
processor memory is set to aR zeros. The word count is not affected by this empty word. Therefore, the 
contents of the A register give the block length minus the number of real data words actually read in. 
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During execution of either of these instructons, address 0000 temporarily holds P, while the P register 
holds m. The contents of P advance by one to give the address for the next word as each word is 
transferred. 

If a read operation overwrites word 0 (address 0000), the restored value of P may be different from the 
contents of P before the operation. 


NOTE 

If this instruction is executed on a CYBER 180 Series; 

CYBER 170 Series; a CYBER 70 Model 71, 72, 73, or 74; 
or 6000 Series machine when the data channel is 
inactive, no operation is accomplished and the program 
continues at P + 2. However, the location specified by m 
is set to all zeros for the lAM instruction. 

On a CYBER 70 Model 76 or a 7600, the 1AM instruction is not executed until the input channel d word flag 
is set. If the flag is not set when the instruction is read, execution halts until an external signal sets the 
flag. The presence of an input channel d record flag is ignored for the first word of the block but 
terminates the block input at any word after the first. In this ease, the next location in the PP block input 
storage area contains a noise word; any remaining locations are unaltered. Note that the storage location 
be incremented through location 7776g to OOOa on a 7600 (or CYBER 70 Model 76), or location 
' '778 through 0000 on a 6000 Series machine (or a CYBER 170 Series; CYBER 70 Model 71, 72, 73 , or 
74), or location 17777g to 0000 on a CYBER 180 Series model 990 and certain 840, 850 and 860 system 
which could destroy existing data or a program. 

On a CYBER 70 Model 76 or a 7600, the OAM instruction is not executed until the output channel d word 
flag is cleared. If the flag is set when the instruction is read, execution halts until a resume pulse clears 
the flag. An output channel d record flag does not affect OAM execution. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

lAM 

m,dt 

Input: (A) words to m from channel d 

24 bits 

71dm 

OAM 

m,dt 

Output: (A) words to channel d from m 

24 bits 

73dm 

tExpression d is required. 



These instructions aUow the transfer of 16-fait PP words to a CYBER 170 12-bit channel (OAPM) or the 
transfer from a CYBER 170 12-bit channel to 16—bit PP words. The data is packed on input from 12—bit 
words to 16-bit words and unpacked on output. Three 16-bit words are assembled from (input) or 
disassembled to (output) four 12-bit words. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

lAPM 

m,dt 

Input: (A) words to m from channel d 

32 bits 

1071dm 

OAPM 

m,dt 

Output: (A) words to channel d from m 

32 bits 

1073dm 

tExpression d is required- 
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Example: 





LOCATION 

OPERATION 

variable 

COMMENTS 


ooue vjciu 


i 


M 

IB 



7103 

1364 



JAM 

TA6,3 

1 -.. 

1 

1 


7304 

1364 



0AM 

TAG,4 

( 

1 


107101 

1364 



lAPM 

TAG,1 

1 

t 


107301 

1364 



OAPM 

TAG,2 

1 

J 

1 



9.2.20 SET OUTPUT RECORD FLAG INSTRUCTION 

The RFN instruction sets the output channel d record flag and transmits a record pulse over the cable. The 
instruction ignores the previous status of the channel d flags; the instruction is executed even if the output 
channel d record flag is set. 

Format: 


Operation 

Variable 

Description 

Size 

Octul Code 

RFN 

cl 

Set oLitixit recoi'cl ilag on chimnel cl 

12 bit!-- 

74cl 


Example: 


Code Generated 


7406 



LOCATION 

OPERATION 

VARIABLE 

COMMENTS 

1 


11 

IB 

30 



RFN 

-r- - 

6 1 

1 


I 9.2.21 CHANNEL FUNCTION INSTRUCTIONS 

The ACN instruction activates the channel specified by d. This instruction must precede the IAN, lAM, 
0AM, or OAN instructions. Activating a channel ederts the input/output equipment for the exchange of 
data. Activating an already active channel causes the PP to become inoperative until another PP or an 
external equipment deactivates the channel, or the system is deadhtarted. 

The DCN iiKtruction deactivates the channel specified by expression d. It stops the input/output 
equipment and terminates the buffer. Deactivating an already inactive channel causes the PP to become 
inoperative until deadstart or until the channel is activated. Avoid disconnecting the channel before first 
sensing for channel empty, deactivating a channel before stopping the associated processor, or deactivating 
a channel before placing a useful program into the associated processor. After deadstart, PPs wait on an 
input channel. Deactivating a channel after deadstart causes an exit to address 0001 and execution of the 
program. 
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The FAN instruction sends the external function code from the lower 12 bits of the A register on channel d. 

The FNC instruction sends the external function code specified by m on channel d. For this instruction, 
expression d is required. 

Execution of a FAN or FNC instruction when the channel is active causes the PP to become inoperative 
until another PP or an external equipment deactivates the channel, or the system is deadstarted. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 


d 

Activate channel d 

12 bits 

74cl 


d 

Disconnect channel d 

12 bits 

75cl 


d 

Function (A) on channel d 

12 bits 

76d 


c,d 

Function c on channel d 

24 bits 

77dni 


Example: 


Code Generated 


lOCATION 

OPERATION 

VARIABU 

COMMENTS 


1 


n 

18 

ho 






7405 



/iCN 

5 

1 - 

1 

75n4 



CCN 

CHAN 

f 

I 

76C5 



FAN 

CHAN4-1 

1 

1 

7705 0020 



FNC 


1 

1 


9.2.22 ERROR STOP INSTRUCTION 

The ESN instruction halts execution of the peripheral processor program and indicates a program error 
condition to the monitor control unit. The PPU must be restarted by a deat^tart sequence from the MCU, 
only. 

Format: 


Operation 

Variable 

Description 

Size 

Octal Code 

ESN 

d 

Error Stop 


7700 


Example: 


Code Generated 


LOCATION 

OPERATION 

VARIABLE 

COMMENTS 


1 


It 

10 

j30 





—-- 

7700 



ESN 

t 

J 
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PROGRAM EXECUTION 


10 


COMPASS can be called from the library and placed in execution through a COMPASS compiler call 
statement or through an IDENT statement (section 4) in a FORTRAN source deck. Ordinarily, when 
COMPASS is called through FORTRAN, the parameters specified on the statement apply also to COMPASS. 


10.1 CONTROL STATEMENTS 

Normally, assembly of COMPASS source programs or the execution of CPU binary object decks is done 
from a job file. A file is usually submitted in the form of card decks or card images. The first section of 
the file must contain the control statements described in this section. Other optional statements are 
described in the operating system reference manual. Following the control statement section are one or 
more sections containing source statements and data. 

A control statement begins with the first nonblank character. A comma or a left parenthesis or blank 
marks the beginning of a parameter string. Parameters in the string are separated by commas. A period or 
right parenthesis terminates a parameter string. Comments optionally follow the terminator. Within the 
parameter strings, blanlcs are ignored. Ordinarily, a parameter can contain only letters and digits. When a 
parameter is enclosed between dollar signs, all characters are permitted and blanks are not ignored. Within 
such a doUar-sign delimited parameter, two consecutive dollar signs represent a single dollar sign. 


10.1.1 JOB STATEMENT 

A job statement of the following format must be the first statement in the deck. The parameters following 
name can be in any order or can be omitted. For any omitted field, a default value is supplied which is an 
installation option. 

Format: 


name, Tt,E Clem, 


name 1 through 7 letters or digits by which the job is identified. 

The first character must be a letter. 

Tt CPU time limit in seconds (NOS/BE 1, SCOPE 2: 1 through 77777g; NOS 1: 1 through 
32760io)- Must be sufficient to process ail control statements for the job, including 
assembly and execution. 

EClem (NOS/BE 1, SCOPE 2 only). Estimate of maximum amount of LCM or ECS in octal 
thousands, required for assembly or execution (l through 14008). 

COMPASS notes storage used in the job dayfile. For subsequent runs, the field lengths can be decreased 
accordingly. 
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Examples: 



10.1.2 COMPASS CONTROL STATEMENT 

The following statement causes the COMPASS assembler to be loaded from the library and executed. 
Parameters specify modes and files. 

Format: 

COMPASS(p^i p^i • ♦ • j P^) 

The optional parameters, p, may be in any order within the parentheses- A parameter can be omitted or 
can be in one of the following forms: 

mode 

mode=:0 

mode=lfn 

Mode is one or two characters as described below; Ifn is a 1 through 7 character name of a file or a 
character string. 


Mode 


Significance 

A - 

Abort mode. 



A 

Abort job step at end of run if any assembly errors occurred. 


omitted 

Do not abort job step for assembly errors. 

B - 

Binary output. 



omitted or B 

Binary on the load-and-go file (LGO). 


B=0 

No binary output. 


B=lfn 

Binary on the named file. 

BL - 

Burstable listing. 



BL 

Generates output listing easily separable into components: 


9 Issues page ejects between listing segments (storage allocation map, 
source code, and cross reference table). 

o Assures an even number of pages (page parity) for each program unit 
listing, issuing a blank page at end if necessary, 

omitted or BL=0 Generates listings in compact format. Page parity and listing segment page 
ejects are suppressed. 
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D - Debug mode, 

D Binary is generated on the file indicated by B parameter in spite of assembly 

errors and regardless of the abort mode (A parameter). The A parameter is 
ignored when the D parameter is selected. 

D is ignored if B=0. 

omitted Assembly errors inhibit binary output. In abort mode (A parameter present), 

no binary output is written at all for a subprogram containing assembly errors. 
Otherwise (A parameter omitted), the message ERRORS IN ASSEMBLY is 
written to the file indicated by the B parameter for each subprogram 
containing assembly errors. 

E - Error list. Suppressed if full list is directed to the same file or if no assembly errors occur. 

However, if the full list and error list are on different files (for example, the full list is written to 
OUTPUT and the error list is written on the named file), the error list will contain aU statements 
having error flags. If an error line was generated by a macro call, the macro caU can also appear in 
the error list. Specification of both the E and the O parameter results in a control statement error. 

omitted Error list on file OUTPUT. 

E Error list on file ERRS. 


F - 


E=lfn 

E=0 


FORTRAN mode, 
omitted or F 
F=number 
F=name 


Error list on named file. 

No error list is generated (equivalent to directing error list to the same file as 
fuU list). 

Establishes value of special element 
♦F is 0. 

♦F is number (one decimal digit). 

♦F is a number corresponding to name as follows: 


COMPASS 0 

RUN = 1 (The RUN compiler is no longer supported.) 
FTN4 = 2 
FTN5 = 3 


G - Get system text, 
omitted or G=0 
G 

G=lfn 


G=lfn/ovl 


Load no system text from a sequential binary file. 

Load the first system text overlay, if any, from file named SYSTEXT. 

Load the first system text overlay, if any, in the specified sequential binary 
file. 

Search the specified sequential binary file for a system text overlay whose 
name is ovl and load the first such overlay. 


I Source of assembler input. 


omitted Source deck is on INPUT file. 

I Source deck is on COMPILE file in either compressed (see the UPDATE 

control statement X option, in the Update reference manual) or expanded 
format. 
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1=0 


Illegal. 

Source deck is on named file. 


I=lfn 

L - Full list. 

omitted or L List output on OUTPUT file. 

L=:lfn List output on named file. When the full list is on a different file than the 

short list (see O option) and the P option is not specified, the listing for each 
subprogram is a separate section beginning with a one-word header consisting 
of an asterisk and the first six characters of the subprogram name. This 
header identifies the subprogram as a convenience for sorting and cataloging. 

L=0 No full list will be generated. 

LO - List options. Selects or deselects a maximum of nine of the list options A, B, C, D, E, F, G, L, M, N, 

R, S, T, or X. 

omitted or LO=0 

LO 

LO=eic2...en 

LO=$$$$ 


Same as selecting B, L, N, and R only. 

Selects list options C, F, G, and X, and deselects R. 

A list of up to nine characters. Inclusion of B, L, N, or R deselects the 
corresponding option. Otherwise, inclusion of a character selects the option. 
For options, refer to LIST pseudo instruction, chapter 4. 

Selects all list options. 


ML - Initial Value of MODLEVEL Micro. 


omitted or ML MODLEVEL is defined equal to JDATE (chapter 7} at the start of each 

assembly. 

ML=string MODLEVEL is defined as string (nine characters maximum) at the start of 

each assembly. 

N - No eject. 

omitted Explicit ejects are honored. 

N Explicit ejects (from TITLE or EJECT pseudo instruction) are suppressed, 

O - Short list. Suppressed if full list is directed to the same file or if no assembly errors occur. 

However, if the full list and short list are on different files (for example, the full list is written on 
OUTPUT and the short list is written on the named file), the short list will contain all statements 
having error flags. If an error line was generated by a macro caU, the macro call may also be in the 
short list. Specification of both the O parameter and the E parameter results in a control statement 
error. 


omitted or O List output on OUTPUT file. 

0=lfn List output on named file. 

0=0 No short list will be generated (equivalent to directing short list to the same 

file as full list). 
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p - 

Continue page. 



P 

Page numbering continues from subprogram to subprogram, creating a single 
continuous listing file. End-of-record is also suppressed between routines on 
the L file. 


omitted 

Page numbering begins with 1 at the start of each subprogram. 

PC - 

Initial Value of PCOMMENT Micro. 


omitted op PC 

PCOMMENT is defined as 30 blanks at the start of each assembly. 


PC=string 

PCOMMENT is defined as string at the start of each assembly. Characters are 
truncated from the right or blanks are appended to the right, as necessary, so 
that the length of the micro value is exactly 30 characters. 

PD - 

Print Density. Job default print density is assumed upon entry. This option affects only the listing 
files. 


PD=6 

Print density is six lines per inch. 


PD=8 or PD 

Print density is eight lines per inch. 


PD=other or 
omitted 

Print density defaults to job default (an installation parameter, user 
changeable) lines per inch. 

PS - 

Page Size. 



PS=x 

Page size is x lines per page. Acceptable values of x are 4<x<99. 


PS=other or 
omitted 

If PD is not specified, page size defaults to job default lines per page. 

If PD is specified, page size defaults to PS=(PD*job default page size)/job 
default print density. 

S - 

System Text Name. 



omitted 

If there are no G parameters other than G=0, load the overlay named 

SYSTEXT from the job^s current global library set. 


S=0 

Load no system text from a library. 


S 

Load system text overlay named SYSTEXT from job^s current global library set. 


S=ovl 

Load the system text overlay named ovl from the job^s current global library 
set. 


S=lib/ovl 

Load the system text overlay named ovl from the library named lib, which may 
be a user library file or a system library. 

X - 

Source of external text (XTEXT) when location field of XTEXT pseudo instruction is blank. 


omitted 

External text OLDPL file. 


X=lfn 

External text on named file. 


X=0 

Illegal. 


X 

External text on OPL file. 
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Example: 




COMPASS{B, D, S=0 VI) 




COMPASS(LO=ASGXD) 


COMPASS. 


Reads source from INPUT, writes the binary output to LOO, 
and the listing to OUTPUT. Assemble in debug niocie with 
system text from overlay OVI in the global library set. 

Disables LIST pseudo instruction and sets LIST options 
A, S, G, Xj and D. 

Uses the standard default options. 


MULTIPLE SYSTEM TEXT OVERLAYS 


COMPASS allows up to seven system text overlays to be used for an assembler run. They are specified by 
G and S parameters on the COMPASS control statement. Each G parameter (except G=0) specifies loading 
of a system text overlay from a sequential binary file, and each S parameter (except S=0) specifies loading 
of a system text overlay from a user library file or a system library. The G and S parameters can be used 
in any combination and in any order, and can be intermixed freely with other parameters, provided the 
total number of system text overlays specified does not exceed seven. COMPASS loads the system text 
overlays in the order in which the G and S parameters occur on the COMPASS statement. If a system 
macro, micro, or symbol is defined by more than one system text, only the last definition is used. S=0 has 
no effect if there are any other S or G petrameters. 


Example: 




COMPASSa, S, S^PFMTEXT, G-=MYTEXT) 


Reads source from file COMPILE and gets svstem 
text from overlays SYSTEXT and PFMTEXT in the 
global library set, and from the local file MVTEXT 


COMPASS(G=FILE/SCPTEXT, S=MYLIB/TEXT) 


Get system text from overlay SCPTEXT 
on the file FILE, and from overlay TEXT 
in library MY LIB. 


10.1.3 LGO CONTROL STATEMENT 

An LGO control statement calls for the loading and execution of CPU binary output produced by the 
assembler unless the B option on the COMPASS control statement is set to 0 or to some other file name. 
When binary output is on some file other than LGO, the statement is replaced by a program call statement 
for that file. The file is automatically rewound before loading. The LGO file is temporary; it is released 
at job termination. 


NOTE 

A peripheral processor program can be executed only by the operating system- This type of 
program execution requires system origin privileges. 

Format: 

/ / 

LGO(p^,P 2 ,P 3 for LGO, 

10.1.4 PROGRAM CALL STATEMENT 

The program call statement directs the operating system to search for a file or CPU program that has the 
specified name, load it into central memory (CM or SCM), and execute it as a CPU program. 
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Formats: 


j/name. 


name Program name- 

Pi Parameters in a format acceptable to the program being called. 

When the operating system locates the file, it rewinds and loads the file. When loading is complete, it 
executes the program as a CPU program- 


10.1.5 7/8/9 CARD 

A card with rows 7, 8, and 9 punched in column one separates sections in the job deck. The level is 
assumed zero unless columns 2 and 3 contain an octal level number punched in Hollerith code. The 
remaining columns optionally contain comments. 

As an example, a deck consisting of a control statement section and a COMPASS source input section 
would include two 7/8/9 cards. The first terminates the control statements and the second terminates 
COMPASS input. A 7/8/9 card of level 17 is interpreted by the operating system as a 6/7/8/9 card. 


10.1.6 6/7/8/9 CARD 

A card with rows 6, 7,8, and 9 punched in column one signals the end of the job deck. Columns 2 through 
80 optionally contain comments. 


10.1.7 USER CONTROL STATEMENT (NOS 1 ONLY) 

The user control statement format is: 

j USES , usernam, password, famname. 

usernam User number or name 

paaswrd User password 

famname Name of user permanent file device family name 


The USER statement, required by NOS 1, follows the job control statement and specifies user access 
information. The user name is used in system booklceeping and defines the user^s file catalog area. The 
user can specify a different permanent file catalog during job processing by issuing another USER control 
statement. 
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10.2 SAMPLE DECKS 

The following job calls for assembly of the source program and execution of the binary object program 
produced by the assembly. The USER control statement (for NOS 1 only) provides required user access 
information. COMPASS reads source statements from file INPUT, writes the listing on OUTPUT, and 
writes a binary object deck on file LGO. Control statement LGO calls for execution of the binary object 
program, which obtains its data from file INPUT. 
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In the following job, the COMPASS assembler is called twice. During the first assembly, binary object 
decks for subprograms TESTl and TEST2 are written on file LGFILEl. The source decks for these 
subprograms are in the second section of the INPUT file. During the second assembly, COMPASS writes a 
binary object deck for subprogram CDA on file LGFILE2. Each assembler run produces a full listing- 
Following the second assembly, LGFILE2 is repositioned to the beginning of the file. Then, the COPYBR 
program is called to copy the contents of LGFILE2 to a punch file (PUNCHB). The LGFILEl statement 
then calls for the loading and execution of subprograms TESTl and TEST2 from LGFILEl, Following 
successful execution of the subprograms, the file is rewound and copied to the punch file, after which the 
job terminates. 


n 


END CDA 


^ roENT CDA 


9 { END TEST2 


IDENT TEST2 


} 

} 


} 


Data for execution 


Subprogram CDA 


Subprogram TEST2 


END TESTl 


IDENT TESTl 


^ Subprogram TESTl 


1 


9 ^ COPYBRfLGFILEl, PUNCHB) 


{REWIND (LGFILEl) 


.( LGFILEl. 


( COPYBR(LGFILE2, PUNCHB) 


{ REWIND(LGFILE2) 


( COMPASS (B=LGFILE2) 


( COMPASS(B=LGFILEl) 



Control 

Section 
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In the following example, the ID ENT statement causes FTN to call COMPASS to process the COMPASS 
source deck. If the COMPASS END statement is not followed by another IDENT statement, then 
COMPASS returns control to the compiler that called it. 



The following sample programs illustrate how to assemble and use a system text overlay. 



IDENT 

MYTEXT 



STEXT 



ONE 

tou 

1 

CONSTANT ONE 

hale 

EUU 

JO 

POS CONSTANT 

SHIFT 

MACRO 

ALPHAtBETA 

POSITIONING MACRO 


IFC 

NtfiALPHA$X2Sf1 


SAiJ 

ALPHA 



IFC 

NttJBtTASBPS 

• I 


SB2 

dtlA 



LX6 

KZtUZ 



ENUM 




END 
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IDtNT TEST 
ENTRY TEST 
SST 


bllOUOOOOl 

bl2G0U00o4 ♦ 

bl20U0003b 

5160U00006 + 

7160247021 

2 

1 
























LISTING FORMAT 


11 


This section describes assembly listing format. Control of the contents of the listing is described in 
section 4.11 Listing Control, and in section 10.1.2 COMPASS Control Statement. 


11.1 PAGE HEADING 

Each page of the assembly listing contains a title line and a subtitle line in the following format: 


title 

COMPASS 

Version 

date 



subtitle 

sub-sub 
title 

block 

name 

symbol 

qual 




title 

date 


Up to 62 characters taken from the first TITLE pseudo instruction or from a 
TTL pseudo instruction or, in lieu of these, from the IDENT instruction 

Date of assembly 


time 
PAGE X 

subtitle 

sub-subtitle 


block name 
symbol qual 


Time of assembly in hours, minutes and seconds 

Page number of listing. Pagination begins with 1 for each END instruction 
unless the P option is selected on the COMPASS control statement 

Up to 62 characters taken from second and subsequent TITLE pseudo 
instructions or a CTEXT pseudo instruction 

Up to 10 characters talcen from the most recent EJECT, SPACE, TITLE, or 
TTL pseudo instruction or the location field of an ES or PS machine instruction. 
If the instruction that introduces the new sub-subtitle also causes a page eject, 
the instruction immediately follows the heading (assuming the C list option is 
also selected). 

Name of the block in use at beginning of page 
Qualifier in use (see QUAL pseudo instruction) 


11.2 HEADER INFORMATION 

The first page of the assembly listing for each subprogram contains a summary of binary control cards 
(optional), a list of all the blocks established for the subprogram, and lists of entry points and 
external symbols. 


11.2.1 BINARY CONTROL CARD SUMMARY 

A binary control card summary in the following format is generated for each IDENT instruction when the 
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COMPASS control statement or the LIST instruction selects the B list option: 


ADDRESS 

LENGTH 

BINABY CONTROL CARDS 

addr^ 


binary card^ 

addr^ 

• 

^2 

binary card^ 

• 

• 

addpjj 


• 

binary card^ 

eop 

(£eop) 

END card or blank 


binary card. The binary card that caused generation of the binary for the overlay, partial 

binary, or subprogram- The list includes SEG, SEGMENT, and IDE NT instruc¬ 
tions. 

addr. The central memory or peripheral processor memory origin address for the 

subprogram, overlay, or partial binary written out as a result of the binary 
card- 

The octal length of the subprogram, overlay or partial binary, in central 
memory words for a central processor assembly, or in peripheral processor 
words for a peripheral processor assembly. 

eop The octal central memory or peripheral processor address for the end of the 

program unit begun by the previous IDENT. 

^®op The octal length in central memory words of a peripheral assembly; not present 

in a listing of a central processor assembly. 


Examples: 


ADDRESS 

LENGTH 

RTNARY 

CONTROL r'A'^OS. 

101 

271 

THP-NT 

f'0HPa<;?,L0VF9,rMP 

17? 


SEG 



124? 

SFG 


7n7«=? 

414*5 

SFG 


ll?k? 

^17*5 

SEG 


2ni*^7 

175? 

SEG 


22011 


END 

COMPASS 


ADDRESS 

LENGTH 

binary 

CONTROL CAROS. 

0 

7761 

IDtMT 

DSO»0 

7761 

(1462) 
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11.2.2 BLOCK USAGE SUMMARY 


A block usage summary of the following format is generated In the assembly listing under control of the 
B list option: 


BLOCKS 

name^ 

name« 


TYPE 

t. 


ADDRESS 

baddr^ 

baddr„ 


LENGTH 


bje„ 


name„ 


baddr 


hi 


namCj^ 


type 


baddr. 

L 

length. 

Examples: 


Name of the block used in the subprogram, as follows: 


PROGRAM* 

ABSOLUTE* 

LITERALS* 

other 


For a relocatable assembly, indicates the zero block. For an 
absolute assembly, the first PROGRAM* Indicates the absolute 
block, the second indicates the default symbols block. 

Appears in a relocatable assembly only and indicates the use 
of an absolute block. 

Identifies the literals block. 

Identifies a local, labeled common, or blank common block. 


The type of the block as follows: 

ABSOLUTE All addresses in the block are relative to absolute zero. For 
an absolute asembly, all blocks are ABSOLUTE. 

+LOCAL Addresses in the block are relative to the origin assigned to 

block zero. The + is present for an ECS/LCM block. 

+COMMON Addresses in the block are relative to the origin of the common 
block. The is present for an ECS/LCM block. 

Beginning address of the block according to type. 

Number of words in the block. 


BLnrKs 

TYPF 

APPRESS 

LENGTH 

PR0G«?AM» 

anSOLilTF 

n 

5416 

LITERALS^ 

APSOLUTF 

541R 

215 

rONTROL 

ARSOLUTF 

5613 

1242 

PSFUDn 

APSHLUTF 

7075 

4145 

SURS 

ABSOLUrr 

13242 

5175 

BUFFERS 

ABSOLUT*^ 

20437 

11140 
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f’LOCKS 

TY“E 

ADDRESS 

LENGTH 

ARSOLUTE^ 

ABSOLUTE 

u 

62 

PROGRAM^ 

LOCAL 

0 

35 

OATAl 

LOCAL 

35 

1 

LCM 

tLOuAL 

0 

5 

TABLE 

+L0CAL 

5 

Cl 

TABLE 

+C0HH0N 

j 

123 

TABLE 

LOCAL 

36 

1 

TABLE 

COHMON 

j 

1 

// 

COHHO'^ 

0 

l.cO 


1L2.3 ENTRY POINT LIST 

If the subprogram declares entry points, a list of entry point symbols in the following format follows the 
block usage summary. 

ENTRY POINTS. 

sym^^+addr^+block^ sym^^^^+addr^^j+block^^j 

symg *+addr2+block2 =y”'2n+2*'^‘*^''2n+2-*^°‘'^2n+2 


sym *+addr +block sym^ *+addr„ 4blocko_ sym« *+addr„ +block_ 

n n n ^ 2n 2n 2n 3n 3n 3n 

Where n is one-third the number of entry points. The asterisk to the right of sym. is present if sym. is a 
conditional entry point (declared by ENTRYC). The + to the left of addr. is present if block, is an ECis/LCM 
block. The + to the right of addr^ is present if addr is relocatable. Block, is blank or a common block 
name surrounded by slashes. ^ ^ 

If the symbol is undefined, addr. is ***♦***, 

Example: 

ENTRY POINTS. 


SNAP! 

1345 + 

CALL 

72 + 


2375+ 

SNAP2 

1352 + 

GOTO 

156 + 

RPF 

2451 + 

SNAP3 

1357 + 

IF 

224+ 

RPH 

24r.3 + 

JUMPVEC * 

D+/JUHPVEC/ 

LABEL 

372 + 

LCM + 

i: + 

BEGIN 

0 + 

READ 

435 + 

LCMR ++ 

i00+/LCM^/ 

BYTESIZ 

6 

RECORD 

24+/nATA/ 




11.2.4 EXTERNAL SYMBOL LIST 

If external symbol references are declared in the subprogram, a list of the following format follows the 
list of entry point symbols: 

EXTERNAL SYMBOLS. 


synij^ 


®y“2n+l 

■ • • 

®y“7n+l 

symg 

®y“n+2 
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sy™n+3 


symg 

9 

sym^ symg^ 

Where n Is one-eLghth the number of external symbols. If a symbol Is a weak external it is 
followed by an asterisk. 

Example. 


FXTFRNflL SYMfJOL’?. 

FRHSG CONEXTT vnrrpl «^YMnOL COGOTO CPC 


11.3 OCTAL AND SOURCE STATEMENT LISTING 

The contents of the octal and source statement listing depends on the options selected. 
The list is 130 characters wide with fields assigned as shown in figure 11-1. 


Title Line 

Subtitle Line 

Error 

Location 

Octal 

Source Lines 

Sequence 

Flags 

Addresses 

Code 

-i 



Figure 11-1. Format of Octal and Source Statement Listing 
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Error Flags 


Location 

Addresses 


Octal Code 


Error flags indicating that errors of the type indicated have been detected on the 
source line or in a subsequent statement that is not listed. These flags are 
described more fully under Error Directory. Lines containing errors are always 
listed. 


The value of the location counter with leading zeros suppressed. If no code is 
generated or no location symbol is defined by the statement, this field is blanlc. 

If at the time the value is assigned, the value of the location counter differs from 
the value of the origin counter, an L precedes the address. 

The actual code generated by this statement. Depending on options selected, the 
listing shows just the first word or all words generated for data generation 
instructions. The field does not include NO instructions (46000g) packed for a 
force upper or zeros packed for a completed parcel on a VFD. A 24-bit PPU 
instruction is shown two words of data per line. 

If the word contains an address, the octal code is flagged as follows: 

Negative relocatable address 
+ Positive relocatable address 
C Common relocatable address 
X External address 


For a statement that does not generate code, this field is normally blank. 
Exceptions are as follows: 

For a LIT instruction the field contains the address of the first word of 
the literals generated- 

For a COL instruction, the field contains the new beginning-of-comments 
column number. 

For a symbol defined through SET, MAX, MIN, EQU, =, or MICCNT, 
this field contains the octal value of the symbol right jus tified with leading 
zeros suppressed. 

For an instruction resulting in a change of base, the notation b^b 2 is right 
justified in the field, bj^ indicates the old base and b 2 indicates the new base. 

For an instruction resulting in a change of code conversion, the notation 
Ci(—^Cg is right justified in the field, indicates the old code and C 2 
indicates the new code. 

For a DUP instruction, the field contains the repeat count. 

For a BSS or BSSZ instruction, the field contains the octal value of the word 
count right justified with leading zeros suppressed* If the word count is 
zero the field is blank. 

For a DECMIC or OCTMIC instruction, the field contains the octal value of 
the expression right justified with leading zeros suppressed. 
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Source Code Source statement image (columns 1 through 72) 

Sequence Columns 73 through 90 of the card image or an identifier for an expansion of a 

definition operation as follows: 


Macro 

Remote code 
Duplicated code 
Echoed code 
XTEXT 
OPDEF 


macro name 
♦RMT* 

♦DUP* 

♦ECHO* 
file name 

Operation field of opdef call, such as SBl 


The recursion level is indicated in the right half of the field. 


Example: 



3.71210 - CYDER 70/ CQMPREHtHSIVE 

ASSEHOLER. 

CQHPASS 3.ri2li .4/>./ri 16.25.U4. 

f ACP' 

12 

COHHOK 

AKB liriLTTY SUDROL/l nJE5. 




alc 






ALC - 

TAOLE HAWACF** ANH ALLOBATnR. 

CIH'ASS 

ISnr 




allocator will nOVE TA^LiS TO ACWIor POO--. AL50 3Uf-P 

ri4!'A5': 

1616 



V 

iMTERtlEDiarE D3 ETf »tUC!? Qflta SC^Arrn FlLf. 

CUI 'A5S 

1- >7 




ENTRY 

CA3J = TAOLt 

COl'''A15 

U 





IKll s CHANCE fiR -> tn TA3Lr S^E. • 

CO'I^A'-.^ 

i ron 



• 

C«IT 

(12> = Q^'ir 

TN Q*^ TAIlE. 

C1‘t:'A* 

17.u 



* 


U3) = RtW 

LCJiGTW TF T«nLE. 

CJH «AjS 

I-*. 1 








t 7.2 








17 ;■■ 


5020011346? 

ALCV 

SA2 

OPTGlNS»Au 

^EELATH values too exit apPLY ' 

r jH-'/i'- * 

4 


50300D35I5 


5M 

5t7E5*Ai 


•JOM- AS' 

1''.5 







STM A- U 

17 6 

51.67 

DJOOOOaODD 

ALC 

PS 


R»*TUPU CVTT 

r 3“*’ 

1- 7 

547& 

6130000034 

AlCl 

512 

NTACILES 

oofri lUUFX *»cr ,tsttri 

a- •* 

I"* n 


5030003462 


54'* 

□“I5tNS»A: 

RRK.IN 

- JM .ftr ; 

1' T 

5*.7l 

54322 


5.13 

A2n2 

rURRfjfT LENir*^ 

C ’"i Af"’ 

171 , 


54421 


5A4 

A2f1l 

♦ICYT TAILS PRIGTU 

V 

1 '1 1 


36513 



)(l*Y3 

tl» W S? 7 ^ 

c 

1'12 


3704? 


I< J 

44-112 

T' SI :r -»nOH F 1 J ‘‘v.-'AMSnN 

c '*t A’- 

1 “Z 3 

5473 

37006 


Itj 

7a-«6 


^3“' 4-: 

1 7» 4 


3330005474 


fJ3 

Y.<*4LC2 

JUNH TO WE* ALL or 4 


1 


54633 


5.16 

A3 

3 Til PE MEW ''•12*' 

C,Tt-'A7*; 

l 71 f. 

5473 

04»>0u05456 


Cl 

ALIt 

ri|T 

riH.-’Au ■; 

1 71 7 







::.*4 ‘ft. " 

17; A 



• 

HIVE 

TARUrS, 


non M' S 

ITlfi 

5474 

512J0J3I72 

AUC2 

542 

SI750RF 

SEE IF rtjaiir.H oritlH 

“T* 1 A*' 

1 7,' 

I ■ M 


164LI 


544 

Yt 


r,i». .AS': 

r'':'r 


67721 


517 

G2-ni 


CO “''.IS'" 

17-3 

5475 

67771 

ALCT 

517 

fir-6i 


r ar • 

1 *’4 


5157603515 


5A5 

5I7=S^R7 


Cn«‘’A» s 

3 7:»i 


36445 


lt4 

X4M5 


r^« 4.*^ 

S 'rf 

5475 

057J0Q5475 


U1 

57tAL33 

LOno 

*- 

i'*7 


5130003345 


i43 

PAil 


“:i** Mi'" 


5477 

63730 


517 

X3 


c:- ass 



37024 


Itl 

«?-t4 


:r,H"4!,<i 

1'i 


63440 

-^0005533 

_ 

514 

517 

X4 

Cn4J = total LE'IGTH 


1 7J1 


11,4 LITERALS 

When the D list option has been selected, the assembly listing includes a listing of the literals block 
following the default symbols listing. Following each literal address are the octal contents of the word and 
a display code conversion of the contents of the word. 
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Examples: 

CONTENT OF LITEB«LS BLOCK. 

0ini2i 

174‘=^5773763aOOOOOQQO 

o+.>>y 

oini2? 

1665000*^000000000000 

Nr* 

01012-^ 

1506232“’a 1070 5553636 

MESSACE 33 

0113124 

55D4D503111501145522 

PFCIMAL R 

01012*5 

05212511 ?^>05045r0 ODD 

EnUTRFH. 

010126 

55??n521?51122a5040n 

PFOUIRf^n 

010127 

00000000000000000000 


OlOlin 

2022170722D115550102 

PROGRAM A0 

oiniTi 

i722?457nnnoonoooono 

pRT. 


CONTENT OF LITERALS BLOCK. 

7316 

0034 

1 

7316 

7070 


7317 

0007 

G 

T320 

onno 


7321 

5501 

A 

73?^ 

0000 


7323 

0506 

FF 

7324 

141 1 

LI 

7326 

2405 

TF 

7326 

2201 

PA 

7327 

1423 

LS 


11.5 DEFAULT SYMBOLS 

When the D list option is selected, a list of default symbols immediately precedes the literals block. 
Example: 

DEFAULT SYMBOLS DEFINED BY COMPASS 


OOOOOQ X 

M5>G= 

00*5461 

TAGl 

00546^ 

TAG2 

00546"^ 

Anr 

Xn5464 

SYM 


11.6 ASSEMBLER STATISTICS 

Assembler statistics are printed at the end of the octal and source statement listing or, if the D list option 
is selected, following the default symbols. Information includes the following: 

Amount of storage used (octal) 

Number of source statements 

Number of symbols defined 

Number of invented symbols 

Number of symbol references 

CPU type in which COMPASS executed and assembly time 
Number of errors encountered during assembly 

Number of lost references, that is, references to symbols that have been omitted from the symbolic 
reference table 
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11.7 ERROR DIRECTORY 

The assembly listing includes an error directory if any errors are detected during assembly. The 
directory begins a new page identified with the subtitle ERROR DIRECTORY. Each type of error that 
occurred is called out with a two-line message of the following format; 

X TYPE ERROR description 

OCCURRED ON PAGES p^, 1^, ... P„ 

Types and descriptions are given in Tables 11-1 and 11-2. Errors flagged with an alphabetic character 
are fatal. A fatal error causes suppression of binary output. Nonfatal warning flags are numeric; they 
are informative only. 


TABLE 11-1. FATAL ERRORS 


Type 

Message 

Significance 

Action 

A 

ADDRESS FIELD 
BAD. 

An error exists in a variable subfield 
entry. The following is a list of 
possible errors: 

The CODE character is not A, D, E, I, 

0, or 

The symbol or name is greater than 8 
characters• 

The expression does not reduce to one 
external tern. 

The relocatable terms do not cancel 
properly. 

The instruction requires an absolute 
expression. 

The instruction disallows register 
designators. 

A data error; 8 or 9 is encountered in 
octal data and the modifier is not S, 

Py 0| Ey Dj or B. 

No data is found in the variable field 
of a LIT instruction. 

No symbol is following an =S, or 

=Y prefix. 

The relative jump is out of range 
(-31>r>31) on a PPU instruction. 

The BASE character is not 0, M, D, 
or 

Refer to the 
manual for the 
correct address 
field format 
for the opera¬ 
tion code 
specified. 
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TABLE 11*-!. FATAL ERRORS (Contd) 



Message 

Significance 

Action 

A 

ADDRESS FIELD 
BAD. (Contd) 

A register is illegal in a CON 
instruetion. 

A synonymous instruction for OPSYN or 

CPSYN cannot be located. 

The micro count is less than zero or 
greater than ten. 

The NOLABEL character is not I. 

A negative relocation is specified on 

ORG or ORGC. 

The POS value is less than 0 or 
greater than word size. 

The OPDEF reference is erroneous. 

No comna is following the DIS word 
count. 

An illegal entry is in the variable 
field of IDENT. 


B 

DOUBLY 

DEFINED 

SYMBOL. 

THE FIRST 
DEFINITION 

HOLDS. 

A symbol has been previously defined 
or declared external. 

Rename the 
duplicate 
symbol in the 
program. 

E 

ECHO, DUP, 

RMT, OR 

MACRO 

ILLEGALLY 

NESTED. 

The definition of ECHO| DUP, RMT, or 

MACRO is not entirely within the next 
outer definition. 

Correc t the 
program. 

F 

NUMBER OF 

ENTRIES 

EXCEEDS 

PERMISSIBLE 

AMOUNT. 

One of the following error conditions 
exists: 

LIT generates more than 100 words. 

Data is missing or erroneous on XTEXT 
file. 

More than 63 formal parameters and 
local names are in a macro definition. 

There are more than 255 blocks. 

There are more than 511 external 
symbols. 

Correct error 
condition and 
rerun the job. 
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TABLE 11-1. FATAL ERRORS (Contd) 



Message 

Significance 

LOCATION 

FIELD BAD. 

The required location field entry is 
erroneous. The format two macro defi¬ 
nition has no substitutable parameters. 

NEGATIVE 
RELOCATION ON 
ENTRY POINT. 

An entry point may not be negatively 
relocated. 

OPERATION 

FIELD BAD. 

One of the following error conditions 
exists in the operation field: 


The instruction is unrecognizable. 


The instruction is out of sequence, 
such as ABS or PPU not in the first 
statement group. 


The instruction is illegal for binary 
mode. 


The relational mnemonic on the IF 
statement is erroneous. 


AIDTEXT has determined that the instruc¬ 
tion has changed or is not valid for the 
models 810, 815, 825, 830, 835, 845, 
and 855. 

CONSULT 

LISTING FOR 
REASON BEHIND 
P-ERROR 

A user-generated error flag from an 

ERR or ERRxx instruction has been 
encountered. 

DATA ORIGIN 
OUTSIDE BLOCK 

OR IN BLANK 
COMMON. 

An attempt was made to set data into 
blank common or beyond block limits. 

UNDEFINED 

STMBOL. 

VALUE 

ASSUMED 0. 

There is a reference to a S3mibol that 
is not defined; for example, an IF 
statement line count, a DIS word 
count, an unrecognizable attribute on 
an IF statement, or an undefined 
qualifier. 

BIT COUNT 

ERROR ON VFD 
(MUST BE 

0 COUNT 60). 

The VFD field size is erroneous. 


Action 


Correct the 
location field 
entry. 

Change to use 
positive or 
absolute 
relocation for 
entry points. 
Rerun job. 

Correct the 

operation 

field. 


Replace 

Instruction. 


Action to be 
taken depends 
upon source of 
error. 

Use labeled 
common or 
increase block 
size and rerun 
job. 

Define the 
symbol• 


Correct the 
size of the VFD 
field. 
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TABLE 11--2. INFORMATIVE MESSAGES 


Type 

Message 

Significance 

Action 

1 

LOCATION SYMBOL 

BAD. SYMBOL NOT 
DEFINED. 

The location field is erroneous. The in¬ 
struction does not require an entry. 

Define or 
eliminate the 
symbol in the 
location field. 

2 

ADDRESS ERROR 

ON SYMBOL 
DEFINITION. 

The variable field entry is erroneous. 

The location field symbol is not defined. 

Correct the sym¬ 
bol definition. 

3 

DUPLICATE MACRO 
DEFINITION. NEW 
ONE OVERRIDES. 

The macro, opdef, or synonymous operation 
redefines the operation code. 

Rename the 
duplicate macro 
name. 

4 

BAD FORMAL 
PARAMETER NAME 
IGNORED. 

The macro or ECHO formal parameter name is 
repeated or illegal. 

Correct the 
formal pa¬ 
rameter name. 

5 

CPU OPERATION 

SYNTAX INCOR¬ 
RECTLY SPECIFIED. 

The OPDEF, CPOP, CPSYN, or PURGDEF speci¬ 
fies an illegal syntax- 

Correct the 
syntax of the 
pseudo 
instruction. 

6 

LOCATION FIELD 
MEANINGLESS. 

The entry in the location field is 
erroneous; it is ignored. 

Correct the 
location field. 

7 

ADDRESS VALUE 
EXCEEDS FIELD 

SIZE, RESULT 
TRUNCATED. 

The value of the address is erroneous; 
one of the following conditions exists: 

The value of the expression exceeds the 
size of the destination field. 

The BSS address expression value is 
negative. 

The MICRO starting character position 
or character count is negative. 

Check the 
possible values 
of the variable 
sub fie Id. 

8 

MISSING OR EXTRA 
ADDRESS SUBFIELD. 

The variable subfield entry is missing 
or superfluous. 

Correct the 
variable 
sub fie Id, 

9 

MICRO SUBSTITU¬ 
TION ERROR. NO 
SUBSTITUTION. 

The micro reference is unrecognizable. 

Correct the 
micro reference. 


11.8 SYMBOLIC REFERENCE TABLE 

The assembler generates a symbolic reference table (figure 11-2) if the L list option is on at the end of 
assembly. The table is not complete if the option was turned off at any time during the assembly. The 
table lists symbols according to the qualifier, if any, under which they were defined. The global symbols 
are listed first. A new heading of the following form introduces each new list of qualified symbols. 

SYMBOL QUALIFIER = qualifier 


j 
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The qualifiers are in the order declared in the subprogram. Symbols are listed alphabetically. 

When symbol references are lost because table space has been exceeded, the subtitle line includes 
notification in the form n LOST REFERENCES. 

Format 1 reflects the XREF P effect; P is the default for the XREF pseudo instruction. Formats 2 and 3 
reflect the effects of XREF B and XREF A, respectively. 



Figure 11-2. Format of Symbolic Reference Table 


symbol Alphabetical list of symbols defined under the qualifier. 

value Absolute value of the symbol or the address assigned to this symbol relative to 

the block named, 

block If the symbol was defined by the SST pseudo instruction, block is the system 

text file or overlay name. Otherwise, this field is blank in an absolute assembly 
or, in a relocatable assembly, it contains the name of the block containing the 
symbol. 

page/lme From left to right and from top to bottom, a list of indices sequenced according 

to page number. Each index points to a statement containing references to the 
symbol or defining the symbol. Present when XREF B or P is in effect, 

address The location counter address of the instruction containing the reference. Pres¬ 

ent when XREF A or B is in effect. 
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flag Identifies page/line index to a statement that defines the symbol or uses it in an 

IF statement as follows; 

D Definition statement; EQU, =, SET, MAX, MIN, or MICCNT 
E ENTRY or ENTRYC pseudo instruction 
F Symbol used in conditional test 

I Symbol used for indirect storage (applies only to PPU or PERIPH 
assemblies) 

L Symbol used in location field of the statement 
S Symbol used for storage 
X EXT pseudo instruction 

When XREF A is in effect, the table does not include the flags. 

Example: 
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COMMON COMMON DECKS 


12 


The common common decks are a set of COMPASS subroutines which are powerful tools for use by 
COMPASS programmers* The common common decks perform functions such as: 

Data conversion 

Dynamic table management 

Saving/restoring registers 

Providing an input/output interface at the CIO and FET level 

All of the common common decks run under NOS and NOS/BE; a subset of them run under SCOPE 2* 

Table 12-1 shows each deck name, relocatable program name, entry point names, and the decks supported 
under SCOPE 2. 

12.1 ACCESS TO THE COMMON COMMON DECKS 

The common common decks are available in two forms: 

As relocatable subroutines 

In source code form as a set of common decks 

Both methods of accessing the common common decks are illustrated in the sample program in appendix D. 

All the common common decks except the table management decks COMCMTM and COMCMTP are 
available as relocatable subroutines that reside on the system library SYSLIB. In this form the common 
common decks are easy to use; relocatable COMPASS programs need only include external references to 
entry point names in the common common decks. These external references are satisfied from SYSLIB at 
load time. (The CYBER loader searches SYSLIB by default when satisfying external references, but the 
SCOPE 2 Loader does not; under SCOPE 2, SYSLIB must be explicitly included in the library set.) 

Occasionally, the programmer may need to access the source code of the common common decks. That 
source code resides on the COMCPL old program library as a set of common decks (see the Update 
reference manual). The source code of these common decks can be made available to a COMPASS program 
in three ways: 

Update-based procedures can use the COMCPL old program library as a secondary old program library 
(see the Update reference manual). The decks are called just as one would call a common deck from 
one^s own old program library. 

Modify-based products can convert the COMCPL old program library to an OPL via the UP MOD 
statement (see the NOS reference manual); the OPL is then used as the source for the common 
common decks. 

The programmer can use the COMPASS XTEXT pseudo-instruction in the program to obtain the source 
code from either an old program library or an OPL (see the X file option of the COMPASS control 
statement). 

The system texts required to assemble the common common decks residing on the COMCPL old program 
library are IPTEXT and CPUTEXT. These texts can be made available to the program via the S parameter 
on the COMPASS control statement. 


60492600 H 


12-1 






XAJBLE 12-1. SUMMARY OF COMMON COMMON DECKS 


Common Common 

Relocatable 

Entry Points 

Available Under 

Deck Name 

Program Name 

SCOPE 2 

COMCARG 

CPU.ARC 

ARG= 

Yes 

COMCCDD 

CPU.CDD 

CDD= 

Yes 

COMCCFD 

CPU.CFD 

CFD= 

Yes 

COMCCIot 

CPU.CIO 

CIO^ 

No 

COMCCOD 

CPU.COD 

COD= 

Yes 

COMCCPT 

CPU.CPT 

CPT= 

Yes 

COMCDXBt 

CPU.DXB 

DXB= 

Yes 

COMCMNS 

CPU.MNS 

MNS= 

Yes 

COMCMOS 

CPU.MOS 

MOS= 

Yes 

COMCMTM 



Yes 

COMCMTP 



Yes 

COMCMVE 

CPU.MVE 

MVE= 

Yes 

COMCRDC 

CPU.RDC 

RDC= 

No 

COMCRDH 

CPU.RDH 

RDH= 

No 

COMCRDO 

CPU.RDO 

RDO= 

No 

COMCRDS 

CPU.RDS 

RDS= 

No 

COMCRDWt 

CPU.RDW 

RDW= RDX= LCB« 

No 

COMCRSR 

CPU.RSR 

RSR= 

Yes 

COMCSFN 

CPU.SFN 

SFN= 

Yes 

COMCSRT 

CPU.SRT 

SRT«= 

Yes 

COMCSST 

CPU.SST 

SST« 

Yes 

COMCSTF 

CPU.STF 

STF= 

No 

COMCSVR 

CPU.SVR 

SVR- 

Yes 

COMCSYS 

CPU.SYS 

SYS= RCL= WNB= MSG= 

No 

COMCUPC 

CPU. UPC 

UPC= 

Yes 

COMCWOD 

CPU.WOD 

WOD= 

Yes 

COMCWTCt 

CPU.WTC 

WTC^ 

No 

COMCWTHt 

CPU.WTH 

WTH==* 

No 

COMCWTOt 

CPU.WTO 

WTO= 

No 

COMCWTSt 

CPU.WTS 

WTS= 

No 


COMCWTWt 

CPU.WTW 

WTW= WTX= DCB^ 

No 

COMCXJR 

CPU.XJR 

XJR= 

No 

COMCZTB 

CPU.ZTB 

ZTB^ 

Yes 


Tnave user defined options 
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12.2 DESCRIPTION OF THE COMMON COMMON DECKS 


A detafled external reference description of each common common deck follows. The decks are described 
in alphabetical order. Each description lists entry and exit conditions, registers used, and routines 
explicitly called. 

The following rules apply to the use of all common common decks: 

Any input/output buffers, string buffers, exchange package save areas, and so forth, to be used by any 
of the common common decks should not be located with the last lOg words of the field length. 

Some fetch loops, move loops, and so forth, may encounter a hardware fault (out of range address) if 
the above restriction is not adhered to. 

Registers that are not used by the common common decks are not modified. 

Entry and exit conditions are only those listed in the descriptions below. 

12.2.1 COMCARG - PROCESS ARGUMENTS 

COMCARG processes a list of arguments (in the format generated by COMCUPC) by the use of an 
equivalence table. The equivalence table must be terminated by a word of aU zeros and must be in the 
following format: 

12/op ,18/asv,12/st,18/addr 

op One or two character keywords (left justified, zero filled) 
asv Address of assumed value 

St Status 

addr Address where argument is placed 

This format is generated by the COMPASS VFD pseudo instruction. ARG= is the only entry point for 
COMCARG. 

Entry conditions: 

(Bl) 1 

(B4) Argument count 

(A4) Address of first argument 

(X4) First argument 

(B5) Address of equivalence table 

Exit conditions: 

(XI) 0 

1 Option not found in table 

2 Single argument equivalenced 

3 Illegal re-entry of argument 

Registers used: 

A2, A3, A4, A7 
B2, B3, B4 

XO, XI, X2, X3, X4, X6, X7 
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The following conditions apply to the use of COMCARG: 

If a keyword=:value form is found in the argument list, addr is set to the upper 42 bits of the argument 
value (in bits 59-18) and the lower 18 bits of asv (in bits 17-0). 

If only a keyword is found in the argument list, addr is set to the full 60 bits of asv. 

If asv 0, the argument cannot be equivalenced. 

If status=4000Q, a zero value is retained as a display code zero. Otherwise, a value of zero (full 
word) is stored at addr. 

If asv=addr, only one entry of that argument is allowed and op is set to -0. 


12.2.2 COMCCDD - CONVERT INTEGER CONSTANT TO DECIMAL DISPLAY CODE 

COMCCDD converts an integer constant to decimal display code. Up to ten digits are converted with 
leading zero suppression. The converted integer contains space fill. One register contains the display code 
right justified; another register contains it left justified. CDD= is the only entry point for COMCCDD. 

Entry conditions: 

(Bl) 1 

(XI) Number to be converted 

Exit conditions: 

(B2) 6 ♦(count of digits converted) 

(X4) Conversion left justified 

(X6) Conversion right justified 

Registers used: 

A2, A3, A4 
B2, B3, B4 

XI, X2, X3, X4, X6, X7 


12.2.3 COMCCFD - CONVERT CONSTANT TO F10.3 FORMAT 

COMCCFD converts a 30 bit integer to display code in FORTRAN F10.3 format. The value returned is 
equal to the input value divided by 1000. The result is returned in two forms: left justified and right 
justified. Leading zeros in the integer portion of the result are suppressed. If the 30-bit input value 
exceeds 999999.999(73465447778), result . An input value greater than 30 bits is 

truncated to the lower 30 bits. CFD= is the only entry point for COMCCFD. 

Entry conditions: 

(Bl) 1 

(XI) Integer to be converted 

Exit conditions: 

(B3) - (number of blank fill bits in result) 

(X4) Conversion left justified 

(X6) Conversion right justified 

Registers used: 
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Al, A2, A3. A4 

B2, B3, B4, B5 

XI, X2, X3, X4, X6, X7 
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12.2.4 COMCCIO - PROCESS I/O OPERATION 

COMCCIO performs input/output operations via the peripheral processor program CIO. An operation is 
performed when the buffer is not busy. If the file-status-word is zero, the operation is not processed and 
IN and OUT are set to FIRST. CIO= is the only entry point for COMCCIO. 

Entry conditions: 

(X2) 24/unused, 18/sldp count to CIO, 18/FET address for file 

(X7) Function code; if 0, X7 is the complement of the request and auto recall is requested 

Exit conditions: 

(X2) FET address 

(X7) 0 

If ERP$ is defined by the user: 

(X2) FET address 

(X7) FET error code: 

0 No error, operation performed, normal exit 

other Error code from FET; operation not performed, exit to ERP$ 

If ERP1$ is defined by the user: 

(X2) FET address 

(X7) FET error code: 

0 No error, operation performed, normal exit 

other Error code from FET; operation not performed, normal exit 

Registers used; 


Al, A6, A7 
XI, X2, X6, X7 


12.2.5 COMCCOD -- CONVERT CONSTANT TO OCTAL DISPLAY CODE 

COMCCOD converts an integer constant to octal display code with leading zero suppression. Up to ten 
digits can be converted. The converted integer contains space fill. One register contains the display code 
right justified, another register contains it left justified. COD= is the only entry point for COMCCOD. 

Entry conditions: 

(Bl) 1 

(XI) Number to be converted 

Exit conditions: 

(B2} 6*(count of digits converted) 

(X4) Conversion left justified 

(X6) Conversion right justified 

Registers used: 

A4 

B2, B3, B4 

XI, X2, X3, X4, X6, X7 
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12.2.6 COMCCPT -- EXTRACT COMMENTS FIELD FROM PREFIX TABLE 


COMCCPT copies the comments field of a prefix (770(^) table to a working storage area. Either the old 
or new forms of the prefix table can be used. COMCCPT differentiates between the forms by checking 
word FWA+3 of the table to see if it lool<s like a time-of-day word. The copy terminates on end-of-table, 
zero byte, or COPYRIGHT. The working storage area is terminated by a zero word. CPT= is the only 
entry point for COMCCPT. 

Entry conditions: 

(Al) Prefix table address 

(A6} Address of working storage 1 

(Bl) 1 

(Xl) Control word 


Registers used: 

A2, A3, A4, A6 
B3, B4 

XI, X2, X3, X4, X6 


12.2.7 COMCDXB ^ CONVERT DISPLAY CODE TO BINARY 

COMCDXB converts a string of display code digits up to one word in length (left-justified and zero-filled) 
into internal integer format. Either a base 10 or a base 8 string of digits can be converted as specified in 
the call. This specification, however, is overridden if an explicit B (octal) or D (decimal) is the last 
character of the value to be converted. DXB= is the only entry point for COMCDXB. 

The assembly option DXB1$ controls the processing of an 8 or 9 when octal is specified for the display code 
value and no explicit B or D appears in the value. If DXB1$ is not defined by the user an error occurs. If 
DXB1$ is defined, the value is considered to be decimal. 

Entry conditions; 

(Bl) 1 

(B7) Basej if 0, decimal base; if 0, octal base. 

(X5) Word to be converted (left justified, zero filled) 

Exit conditions: 

(X6) Converted digits 

(X4) Error code: 

0 No error 

other Error in assembly 

Registers used: 

B2, B3, B4, B5 

XO, XI, X2, X3, X4, X5, X6, X7 

The presence of one or more of the following always causes an error; 

A non-digit in the word to be converted 

A character after the post radix 

An 8 or 9 with the post radix equal to B 
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12.2.8 COMCMNS - MOVE NON-OVERLAPPING BIT STRING 

COMCMNS moves a specified source string from one location to another in central memory. The only bits 
disturbed in the destination field are those extracted to accept the source string. The destination field 
must not overlap the source field in any way; results are undefined if overlapping occurs; COMCMOS can 
be used for overlapping moves. MNS= is the only entry point for COMCMNS. 

Entry conditions: 

(Bl) 1 

(B2) Source first bit (numbered left to right - 0, 1,..., 59) 

(B4} Destination first bit (numbered left to right - 0, 1,..., 59) 

(XO) Number of bits to move 

(X2) Source first word address 

(X4) Destination first word address 

Exit conditions: 

(Bl) 1 

{B2) Source next bit (numbered left to right - 0, 1,..., 59) 

(B4) Destination next bit (numbered left to right - 0, 1,..., 59) 

(X2) Source next word address 

(X4) Destination next word address 

Registers used: 

Al, A2, A3, A5, AG 

B2, B3, B4, B5, B6 

XO, XI, X2, X3, X4, X5, X6, X7 


12.2.9 COMCMOS - MOVE OVERLAPPING BIT STRING 

COMCMOS moves a specified source string from one location to another in central memory. The only bits 
disturbed in the destination field are those extracted to accept the source string. COMCMOS allows the 
user to move strings where the destination field overlaps (lies partly or completely within) the source 
field. If the move is not an overlap move, COMCMOS calls the faster common common deck COMCMNS to 
do the move. For this reason, COMCMNS should always be called whenever COMCMOS is. MOS= is the 
only entry point for COMCMOS. 

Entry conditions: 

(Bl) 1 

(B2) Source first bit (numbered left to right - 0, 1,..., 59) 

(B4) Destination first bit (numbered left to right - 0, 1,..., 59) 

(XO) Number of bits to move 

(X2) Source first word address 

(X4) Destination first word address 

Exit conditions: 

(Bl) 1 

(B2) Source next bit (numbered left to right - 0, 1,..., 59) 

(B4) Destination next bit (numbered left to right - 0, 1,..., 59) 

(X2) Source next word address 

(X4) Destination next word address 


60492600 M 


12-7 










Registers used: 

Al, A2, A3, A5, A6, A7 

B2, B3, B4, B5, B6 

XO, XI, X2, X3, X4, X5, X6, X7 

Calls: 

IVINS= 

12.2.10 COMCMTM - MANAGED TABLE MACROS 

COMCMTM contains four macros, ADDWRD, ALLOC, SEARCH, and TABLE, for generation, allocation, 
and processing of managed tables. COMCMTM is intended to be used with COMCMTP, 

ADDWRD - ADD WORD TO TABLE 

ADDWRD adds a word to a managed table. ADDWRD calls ADW and uses AO and XI. 

Format: 


lOCATION 

OPEIATION 

VASIABIE SUBFIEIOS 


ADDWRD 

table, reg 


table Table number 

reg Register name or expression for word to be added 
ALLOC - ALLOCATE TABLE SPACE 

ALLOC allocates table space. ALLOC calls ATS and uses AO and XI. 
Format: 


lOCATION 

OPERATION 

VAllABlf SUeflELDS 


ALLOC 

table,words 


table Table number 
words Word count (+ or -) to be added 
SEARCH - SEARCH MANAGED TABLE 

SEARCH searches for a specified entry. SEARCH calls EQS or MES and uses AO, B7, and X6. 
Format: 


LOCATION 

OPERATION 

VARIABLE 5UBFIEIDS 


SEARCH 

tname, entry, mask 


tname Table name 

entry Entry to be searched for 

mask Search mask in XO; if not present, defaults to all bits. 
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TABLE - GENERATED MANAGED TABLE 
TABLE generates a managed table. 
Format: 


LOCATION 

OPESATION 

VARIABLE SUBFIELDS 


TABLE 

tname, count, equiv 


tname Table name 

count Word count per entry (1 if not specified) 

equiv Equivalent table name; allows certain tables to be used by different processors 
After the table is generated: 

F.tname is the name of the word containing the table FWA. 

L.tname is the name of the word containing the table length. 

C.tname is the word count per entry. 

12.2.11 COMCMTP - MANAGED TABLE PROCESSORS 

COMCMTP contains the following routines for processing managed tables: 

ADW Adds a word to the table. 

AMU Returns the total memory used by the tables. 

ATS Allocates table space. 

EQS Searches table for equal entries. 

MES Searches a table for equal entries using a mask. 

MTD Moves the table down. 

MTU Moves the table up. 

Macros for calling these routines and for table generation are contained in COMCMTM. 

The managed table processors allow the partitioning of central memory into variable regions called tables. 
These tables are referenced by pointers that indicate the first word address of the table and the table 
length. Memory is allocated to each table as it is required; the user can delete space from the tables. 

Each table is allowed at least one word of expansion space to allow a dummy word between each table, thus 
ensuring efficient search methods. 

The caller of the table processors is expected to provide certain constants for use by the processors. Other 
data is provided by COMCMTM. 

Data provided by the caller: 

MEML Lowest address of managed memory 

TOY Address of the table overflow processor 
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Data provided by COMCMTM: 

NTAB 

Number of managed tables 

FTAB 

Start of table addresses 

LTAB 

Start of table lengths 

F.tnam 

Address pointer for table tnam 

L.tnam 

Length pointer for table tnam 


Data dynamically changeable: 

TN Number of managed tables. Set to NTAB by COMCMTM. TN must be less than NTAB 

during use. 

TO Table overflow processor. Set to TOV by COMCMTM. 

LM Low memory limit. Set to MEML by COMCMTM. If this value is increased, MTU should be 

called to allow room for change, 

F.TEND High memory limit. F.TEND must be initialized by the user. If this value is decreased, 

MTD should be called to allow room for change, 

TOVT TOV threshold. If the word is defined, it should contain the threshold for calling TOV; ATS 
calls TOV when the tables must be moved and less than TOVT free words remain. If TOVT is 
not defined, an effective value of zero is used, 

ADW - ADD WORD TO TABLE 

ADW adds a word to a managed table. 

Entry conditions: 

(AO) Table number 

(XI) Word to be added 

Exit conditions: 

(A6) Address of added word 

(XI) Added word 

(X2) FWA of table 

(X3) Length of table 

(X6) Added word 

Registers used: 

Al, A2, A3, A4, A6, A7 
XI, X2, X3, X4, X6, X7 

Calls: 

ATS 

AMU - ACCUMULATE MEMORY USED 

AMU returns the amount of memory used by the managed tables or the current length, whichever is the 
largest. The variable MU is set to this value. 
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Exit conditions: 


MU MAX(memory used, current assigned length) 

Registers used: 

Al. A2, A6 
B2 

XI, X2, X3. X6 

ATS - ALLOCATE TABLE SPACE 

ATS allocates table space* The table length can be increased or decreased as specified. 

Entry conditions: 

(AO) Table number 

(XI) Change (+ or -) to the table size 

Exit conditions: 

(XI) Change made to the table size 

(X2) FWA of table 

(X3) New length of table 

(X7) Less than 0 if tables moved 

Registers used if tables are not moved. 

A2, A3, A4, A6 
X2. X3, X4, X6, X7 

Registers used if tables are moved: 

Al. A2, A3, A4, A6, A7 

B2, B3, B4, B5, B6, B7 

XO, XI, X2, X3, X4, X5, X6, X7 

Registers restored: 

B2, B3, B4, B5, B6, B7 (except -0 restored as +0) 

XO, XI, X5 

Calls: 

AMU, MVE=, TOV 

TOV, the user provided table overflow processor, is described below. 

Entry conditions: 

(Bl) 1 

(B5) Complement of number of words required 

(B6) Return address to continue processing 

The location TOV must contain executable code. TOV is entered via a JP instruction. 
Exit from TOV via a JP B6 instruction. 
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Exit conditions: 


Only B1 must be preserved- 

A pointer word must be incremented by the number of words newly available. If TN has not been 
altered during execution, the address of the pointer word is F.TEND. If TN has changed, the address 
of the pointer word is FTAB-1 plus the contents of TN. 

EQS - EQUALITY SEARCH TABLE 

EQS searches for a specified entry. 

Entry conditions: 

(AO) Table number 

(B7) Word count per entry 

(X6) Entry for search 

Exit conditions; 

(X2) = 0 if entry not found 

(X2) = entry, if found 

(A2) = address of entry found 

Registers used: 

Al, A2, A6 
XI, X2, X3, X7 

MES - MASKED EQUALITY SEARCH TABLE 

MES searches for a specified entry using a mask. 

Entry conditions: 

(AO) Table number 

(B7) Word count per entry 

(XO) Mask 

(X6) Entry for search 

Exit conditions; 

(X2) = 0 if entry not found 

(X2) = entry, if found 

(A2) = address of entry found 

Registers used: 

Al, A2, A6 

XI, X2, X3, X4, X7 

MTD - MOVE TABLES DOWN 

MTD moves the tables down (away from RA) to eliminate unused memory. 

Exit conditions: 

(B2) Number of tables 
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Registers used: 


Al. A2, A3, A7 
B2, B3 

XO, XI, X2. X3, X4, X7 
Calls: 


MVE= 

MTU - MOVE TABLES UP 

MTU moves the tables up (toweu'd RA) to eliminate unused memory. 

Registers used: 

Al, A2, A7 
B3 

XO, XI, X2, X3, X7 
Calls: 

MVE= 


12.2.12 COMCMVE - MOVE BLOCK OF DATA 

COMCMVE moves a block of data to a specified location. COMCMVE moves the data from the source 
address through the source address plus the word count minus one to the destination address through the 
destination address plus the word count minus one. The move can be in either direction. MVE= is the only 
entry point for COMCMVE. 

Entry conditions: 

(Bl) 1 

(XI) Word count 

(X2) Source address 

(X3) Destination address 

Registers used: 

A2, A4, A6, A7 
B7 

XI, X2, X3, X4, X6, X7 


12.2.13 COMCRDC - READ CODED LINE, C FORMAT 

Before a data transfer routine is caUed, a CIO read function macro (READ, READW, and so forth) must be 
used to establish the type of read and initialize the type of transfer required. 

If any other type of CIO function is used (REWIND, SKIP, and so forth) on the fUe, it may be necessary to 
reestablish the type of read/transfer before another data transfer routine is caUed. 

When an EOR or EOF is sensed while performing the data transfer, the CIO read function macro must be 
caUed again to continue reading the fUe. Refer to the NOS or NOS/BE reference manual for a description 
of the CIO macros, 

COMCRDC reads a coded line terminated by a zero byte from a CIO buffer to a working buffer. RDC= is 
the only entry point for COMCRDC. 
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Entry conditions: 


(B6) FWA of working buffer 

(B7) Word count of working buffer 

(X2} Address of FET for file 

If B7 is less than zero, then the complement of B7 is the word count of the working buffer; COMCRDC 
will not read and discard words until an end-of-line for lines longer than the working buffer. 

Exit conditions: 

(Bl) 1 

(B6) Address of last word transferred to working buffer plus one 
(XI) Status of transfer: 

0 Transfer completed 

-1 EOF detected on file 

-2 EOI detected on file 

B6 EOR detected on file before transfer completed 

(X2) Address of FET for file 

(X4) Contents of last data word transferred before EOL guaranteed 
(X7) Level number of EOR 

Registers used; 

Al, A2, A3, A4, A6, A7 
Bl, B2. B3, B4, B5, B6. B7 
XI, X2, X3, X4, X6, X7 

Calls: 

LCB=, RDX= 


12.2.14 COMCRDH - READ CODED LINE, H FORMAT 

Before a data transfer routine is called, a CIO read function macro (READ, READW, and so forth) must be 
used to establish the type of read and initialize the type of transfer required. 

If any other type of CIO function is used (REWIND, SKIP, and so forth) on the file, it may be necessary to 
reestablish the type of read/transfer before another data transfer routine is caUed. 

When an EOR or EOF is sensed while performing the data transfer, the CIO read function macro must be 
caRed again to continue reading the file. Refer to the NOS or NOS/BE reference manual for a description 
of the CIO macros. 

COMCRDH reads a coded line terminated by a zero byte from a CIO buffer to a working buffer with 
trailing space fill. RDH= is the only entry point for COMCRDH. 

Entry conditions: 

(B6) FWA of working buffer 

(B7) Word count of working buffer 

(X2) Address of FET for fUe 

Exit conditions: 

(Bl) 1 

(B6) Address of last word transferred to working buffer plus one 
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(XI) Status of transfer: 

0 Transfer completed 

EOF detected on file 
-2 EOI detected on file 

B6 EOR detected on file before transfer completed 
(X2) Address of FET for fUe 

(X7) Level number of EOR 

Registers used; 

Al, A2, A3, A4, A6 
Bl, B2, B3, B4, B5, B6, B7 
XI, X2, X3, X4, X6, X7 

Calls: 


LCB=, RDX= 


12.2.15 COMCRDO - READ ONE WORD 


Before a data transfer routine is called, a CIO read function macro (READ, READW, and so forth) must be 
used to establish the type of read and initialize the type of transfer required. 

If any other type of CIO function is used (REWIND, SKIP, and so forth) on the file, it may be necessary to 
reestablish the type of read/transfer before another data transfer routine is called. 

When an EOR or EOF is sensed while performing the data transfer, the CIO read function macro must be 
called again to continue reading the file. Refer to the NOS or NOS/BE reference manual for a description 
of the CIO macros. 

COMCRDO reads one word from a CIO buffer into X6. RDO= is the only entry point for COMCRDO. 

Entry conditions: 

(Al) Address of IN pointer 

(XI) IN 

Exit conditions: 

• (Bl) 1 

(Xl) Status of transfer: 

0 Transfer completed 

1 EOR detected on file 

-1 EOF detected on file 

-2 EOI detected on file 

(X2) Address of FET for file 

(X6} Word read 

Registers used: 

Al, A2, A3, A4, A6, A7 
Bl 

XI, X2, X3, X4, X6, X7 
Calls: 


CIO= 
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12.2.16 COMCRDS - READ CODED LINE TO STRING BUFFER 


Before a data transfer routine is called, a CIO read function macro (READ, READW, and so forth) must be 
used to establish the type of read and initialize the type of transfer required. 

If any other type of CIO function is used (REWIND, SKIP, and so forth) on the file, it may be necessary to 
reestablish the type of read/transfer before another data transfer routine is called. 

When an EOR or EOF is sensed while performing the data transfer, the CIO read function macro must be 
called again to continue reading the file. Refer to the NOS or NOS/BE reference manual for a description 
of the CIO macros. 

COMCRDS reads a coded line from a CIO buffer to a working buffer. Words in the circular buffer are 
unpacked and stored one character per word in the working buffer. This process is continued until the 
end-of-line byte is detected. If the coded line terminates before the working buffer is filled, the worldng 
buffer is padded with spaces; the buffer is not padded if the complement of the word count of the buffer 
used. If the coded line exceeds the size of the working buffer, the excess characters are ignored. RDS= 
the only entry point for COMCRDS. 

Entry conditions: 

(B6) FWA of working buffer 

(B7) Word count of working buffer 

(X2) Address of FET for file 

If B7 is less than 0, B7 is the complement of the buffer length and the string buffer will not be space 
filled. 

Exit conditions: 

(Bl) 1 

(B6) Address of the last character from the coded line in the working buffer plus one 
(XI) Status of transfer: 

0 Transfer completed 

-1 EOF detected rni fRe 

-2 EOI detected on file 

B6 EOR detected on fRe before transfer completed 

(X2) Address of FET for fRe 

(X7) Level number of EOR 

Registers used: 

Al, A2. A3, A4, A6, A7 
Bl, B2, B3, B4, B5, B6, B7 
XI, X2, X3, X4, X6, X7 

Calls: 

LCB=, RDX= 


12.2.17 COMCRDW - READ WORDS TO WORKING BUFFER 

Before a data transfer routine is caUed, a CIO read function macro (READ, READW, and so forth) must be 
used to estabUsh the type of read and initialize the type of transfer required. 

If any other type of CIO function is used (REWIND, SKIP, and so forth) on the fRe, it may be necessary to 
reestabRsh the type of read/transfer before another data transfer routine is caRed. 
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When an EOR or EOF is sensed while performing the data transfer, the CIO read function macro must be 
called again to continue reading the file. Refer to the NOS or NOS/BE reference manual for a description 
of the CIO macros. 


COMCRDW reads a specified number of words from a CIO buffer to a working buffer. COMCRDW also 
contains the load CIO buffer and read exit routines required by COMCRDC, COMCRDH, and COMCRDS, 
RDW=, LCB=:, and RDX= are the entry points for COMCRDW. The RDX$ assembly option controls 
read-^ead. The programmer can prevent read“*ahead by defining the symbol RDX$, 

Entry conditions: 

(B6) FWA of working buffer 

(B7) Word count of working buffer 

(X2) Address of FET for file 


Exit conditions: 

(Bl) 1 

{B6) Address of last word transferred to the working buffer plus one 
(B7) Word count remaining to be transferred 

(XI) Status of transfer: 

0 Transfer completed 

-1 EOF detected on file 

-2 EOI detected on file 

-3 CIO= was called to read more data and returned an error status 

B6 EOR was detected on file before transfer was completed 

(X2) Address of FET for file 

(X7) Error status if XI is -3, otherwise level number of EOR 

Registers used: 

Al, A2, A3, A4, A6, A7 
Bl, B2, B3, B4, B5, B6, B7 
XI, X2. X3, X4, X6, X7 

Calls: 


CIO= 


12.2.18 COMCRSR - RESTORE ALL REGISTERS 

COMCRSR restores the B, A, and X registers from a specified register save area. The format of the 
registers in the save area is BO, Bl,..., B7, AO, Al,..., A7, XO, XI,..., X7. Each register occupies a full 
word with the B and A register values in bits 17 through 0. RSR“ is the only entry point for COMCRSR. 

Entry conditions: 

(Xl) Address of register save area 
Exit conditions: 

All registers are set to the content of the register save area. 

Registers used: 

AO, Al, A2, A3, A4, A5, A6, A7 
Bl, B2, B3, B4, B5, B6, B7 
XO, XI, X2,X3, X4, X5, X6, X7 
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12.2,19 COMCSFN - SPACE FILL NAME 

COMCSFN converts trailing 00 characters in a word to blanks. SFN= is the only entry point for COMCSFN. 
Entry conditions: 

(XI) Name left justified, zero fill 

(Bl) 1 

Exit conditions: 

(X6) Name space filled 

(X7) Final character mask 

Registers used: 

A3 

B2 

X3, X6, X7 


12.2.20 COMCSRT SET RECORD TYPE 

COMCSRT attempts to identify the format of a record, given the initial part of that record (64 words are 
usually sufficient) in a working buffer. The type codes returned are listed in table 12-2. SRT= is the only 
entry point for COMCSRT. 

Entry conditions: 

(Bl) 1 

(XI) LWA+1 of block 

(X2) FWA of current record 

Exit conditions: 

(X6) 42/OLr^name, 12/0, 6/type number 
(X7) Record name in L format 

If type number and record name are zero, the record is zero length. 

Registers used: 

Al, A2, A3, A7 
B2, B3 

XO, XI, X2, X3, X4, X6, X7 


12.2.21 COMCSST - SORT TABLE USING SHELL SORT 

COMCSST sorts a table of one word entries into ascending order using a shell sort. All of the entries 
should be of the same sign. SST= is the only entry point for COMCSST. 

Entry conditions: 

(Bl) 1 

(B7) Address of table to be sorted 

(XI) Number of elements in the table 

Exit conditions: 

The table is sorted. 
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TABLE 12-2. TYPE CODES RETURNED BY COMCSRT 


Type 

TEXT 

6PP 

OVCAP 

REL 

OVL 

ULIB 

OPL 

OPLC 

OPLD 

ABS 

7PP 

UPLX 

UCF 

ACF 

CAP 

DATA 

PROG 

SDR 

UPLR 
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Registers used: 


Al, A2, A6, A7 

B2, B3. B4, B5 

XI, X2. X3, X4, X6, X7 


12.2.22 COMCSTF - SET TERMINAL FILE 

COMCSTF detects if a file is assigned to an interactive terminal. STF= is the only entry point for 
COMCSTF. 

Entry conditions: 

(Bl) 1 

(X2) Address of FET 

The FET must be greater than five words in length. 

Exit conditions: 

(X2) Address of FET 

(X6) 0 if file is assigned to a terminal 

Registers used: 

Al, A4, A6 
XI, X3, X4, X6 

Calls: 


CIO= 


12.2.23 COMCSVR -- SAVE ALL REGISTERS 

COMCSVR saves the B, A, and X registers in a specified register save area. The registers are saved in the 
following order: 

BO, Bl.B7. AO, Al,,,,. A7, XO, XI,.,., X7 

Each register occupies a full word with the B and A register values in bits 17 through 0, B and A registers 
are sign extended. SVR= is the only entry point for COMCSVR. 

Entry conditions: 

Bits 17 through 0 of the word from which SVR= was called contain the address of the register save 
area. 

Exit conditions: 

(save thru save+7) B registers 

(save+8 thru save+15) A registers 

(save+16 thru save+23) X registers 

Registers used: 

AO, Al, A2, A3, A4. A5, A6, A7 
Bl, B2, B3, B4, B5, B6, B7 
XO, XI, X2, X3, X4, X5, X6, X7 
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12.2.24 COMCSYS ^ PROCESS SYSTEM REQUEST 


COMCSYS issues a system monitor request through RA+1. SYS=, RCL=, WNB=, and 1VISG= are the entry 
points for COMCSYS. 

SYS= - PROCESS SYSTEM REQUEST 

SYS= waits for RA+1 to clear before issuing the desired request. Central exchange jump hardware is used 
if it is available. If the hardware is not available and the auto-reeall bit is set, SYS= waits for the monitor 
to process the call before returning. 

Entry conditions: 

(X6) System request 

Exit conditions: 

Request accepted by monitor 

Registers used: 

Al, A6 

X6 (Contents restored upon exit) 

RCL= - PLACE PROGRAM ON RECALL 

RCL= issues a single system request for periodic recall- If RA+1 is busy, no request is issued. 

Exit conditions: 

Request processed. 

Registers used: 

A1 

XI, X6 

WNB= - WAIT NOT BUSY 

WNB= waits for a specified status word, bit 0, to be set. If the word is initially 0, WNB= returns. 

Entry conditions: 

(X2) Address of status word 
Exit conditions: 

Returns when bit 0 of status word is set. 

Registers used: 

A1 

XI, X6 

MSG= - SEND MESSAGE 

MSG= formats and issues a system request to send a message (80 characters or less) to the job dayfile. The 
message appears in the dayfile as two lines (if necessary) of 40 characters each. Messages exceeding 
80 characters are truncated. 
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Entry conditions: 

(XI) Address of first word of data (data must be packed in sequential locations, and should not 
exceed 80 characters) 

(X6) Message options: 

bit 16 - Auto recall if on 

bits 11 through 0 “ Message option code (see MESSAGE macro in operating system 
reference manual) 

Exit conditions: 

Returns when operation is complete. 

Registers used: 

Al, A6 
XI, X6 

12,2.25 COMCUPC - UNPACK CONTROL CARD 

COMCUPC unpacks a control statement into the keyword and individual parameters. The following 
conditions apply to the use of COMCUPC: 

If B7 is negative on entry, a blank after the keyword is considered to be a separator; otherwise, blanks 
are ignored. 

The characters ) and . are considered as the termination of the control statement. 

Characters with display code values 0 or SOg through TTg are illegal before the terminator. 

The parameter must contain 7 or fewer characters. 

The parameters are stored left-justified with zero fill. 

The separator character is placed in the lower 18 bits of the parameter unless it is a in which 
case the lower 18 bits are zero. 

Two successive separators or a separator followed by a terminator results in a parameter of all zeros. 
UPC= is the only entry point for COMCUPC. 

Entry conditions: 

(A5) Address of first word of control statement 

(Bl) 1 

(B7) First word address of buffer containing parameter information 
(X5) First word of control statement 

If B7 is negative, B7 contains the complement of the first word address of the parameter buffer. 

Exit conditions: 

(B6) Parameter count 

(X6) 0 if no error during unpacking 

Registers used: 

Al, A2, A5, A6, A7 

B2, B3, B4, B5, B6 

XO, XI, X2, X3, X4. X5, X6, X7 
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12.2.26 COMCWOD - CONVERT WORD TO OCTAL DISPLAY CODE 

COMCWOD converts a word into octal display code, WOD= is the only entry point for COMCWOD. 

Entry conditions; 

(XI) Word to be converted 

Exit conditions: 

(Bl) 1 

(X6, X7) Conversion 

Registers used: 

A2, A3, A4, A5 

XO, XI, X2, X3, X4, X5, X6, X7 


12.2.27 COMCWTC - WRITE CODED LINE, C FORMAT 

COMCWTC writes a zero byte delimited line from a working buffer to a CIO buffer. If the CIO buffer 
becomes sufficiently full to require writing or if the device type indicates a NOS/BE terminal, COMCWTC 
performs a WRITE function unless the symbol WRIF$ is defined by the user. In this case, the CIO function | 
that is in the FET is reissued. WTC= is the only entry point for COMCWTC. 

When the data transfer is completed, a call to the WRITER or WRITEF CIO function is necessary to obtain 
the final contents of (to flush) the working buffer. 

Entry conditions: 

(B6) FWA of working buffer 

(X2) Address of FET for file 

Exit conditions: 

(Bl) 1 

(X2) Address of FET for file 

Registers used; 

Al, A2, A3, A4, A6, A7 
Bl, B2, B3, B4, B5, B6 
XI, X2, X3, X4, X6, X7 

Calls: 


DCB=, WTX= 


12.2.28 COMCWTH - WRITE CODED LINE, H FORMAT 

COMCWTH writes a coded line in H format from a worldng buffer to a CIO buffer. Trailing spaces £u:e 
deleted. If the buffer becomes sufficiently full to require writing, or the device type indicates a NOS/BE 
terminal, COMCWTH performs a WRITE function unless the user defines the symbol WRIF$. In this case, | 
the CIO function that is in the FET is reissued. If the line to be written terminates with 6 bits of zero, a 
word containing a blank byte is appended to preserve the 00 character as a colon. If the line terminates on 
an end-of’-line, it is written as is. WTH= is the only entry point for COMCWTH. 
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When the data transfer is completed, a call to the WRITER or WRITEF CIO function is necessary to obtain 
the final contents of (to flush) the working buffer. 

Entry conditions: 


(B6) FWA of working buffer 

(B7} Word count of working buffer 

(X2} Address of FET for file 

If B7 is 0, no transfer is performed. 

Exit conditions: 

(Bl) 1 

(X2) Address of FET for file 

Registers used: 

Al, A2, A3, A4, A6, A7 
Bi, B2, B3, B4, B5, B6, B7 
XI, X2, X3, X4, X6, X7 

Calls: 


DCB=:, WTX= 


12.2.29 COMCWTO - WRITE ONE WORD 

COMCWTO writes one word to a CIO buffer from X6. If the buffer becomes sufficiently full to require 
I writing, COMCWTO performs a WRITE function unless the symbol WRIF$ is defined by the user. In this 
case, the CIO function that is in the FET is reissued. WTO= is the only entry point for CDMCWTO. 

When the data transfer is completed, a call to the WRITER or WRITEF CIO function is necessary to obtain 
the final contents of (to flush) the working buffer. 

Entry conditions: 

(Al) Address of IN pointer 
(XI) IN 

(X6) Word to write 

Exit conditions: 

(Bl) 1 

(X2} Address of FET for file 

Registers used: 

Al, A2, A3, A4, A6, A7 
Bl 

XI, X2, X3, X4, X6, X7 
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12.2.30 COMCWTS - WRITE CODED LINE FROM STRING BUFFER 


COMCWTS writes a coded line from a working buffer to a CIO buffer with trailing space suppression. 
Characters in the worldng buffer are packed and stored in the circular buffer. If the buffer becomes 
sufficiently full to require writing or if the device type indicates a NOS/BE terminal, COMCWTS performs 
a WRITE function unless the symbol WRIF$ is defined by the user. In this case, the CIO function that is in 
the FET is reissued. WTS= is the only entry point for COMCWTS. 

When the data transfer is completed, a call to the WRITER or WRITEF CIO function is necessary to obtain 
the final contents of (to flush) the working buffer. 

Entry conditions: 

(B6) FWA of working buffer 

(B7) Word count of working buffer 

(X2) Address of FET for fRe 

If B7 is 0, no transfer is performed. 

Exit conditions: 


(Bl) 1 

(B6) Word count of data written 

(X2) Address of FET for file 

Registers used: 

Al, A2, A3, A4, A6, A7 
Bl, B2, B3, B4, B5, B6, B7 
XI, X2, X3, X4, X6, X7 

Calls: 


DCB=, WTX= 


12.2.31 COMCWTW - WRITE WORDS FROM WORKING BUFFER 

COMCWTW writes data from a working buffer to a CIO buffer. If the buffer becomes sufficiently full to 
require writing or if the device type indicates a NOS/BE terminal, COMCWTW performs a WRITE function 
unless the user defines the symbol WRIF$. The WTX$ assembly option controls write-behind. The 
programmer can prevent write-behind by defining the symbol WTX$. In this case, the CIO function that is 
in the FET is reissued. WTW=, DCB=, and WTX= are the entry points for COMCWTW. 

When the data transfer is completed, a call to the WRITER or WRITEF CIO function is necessary to obtain 
the final contents of (to flush) the working buffer. 

Entry conditions: 

(B6) FWA worldng buffer 

(B7) Word count of working buffer 

(X2) Address of FET for file 

If B7 is 0, no transfer is performed. 
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Exit conditions: 

(Bl) 1 

(B6) Address of next word to be transferred from working buffer 
(B7) Status of transfer: 

0 Transfer completed 

other Remaining word count if CIO= was called to write data and returned an error 
status 

(X2) Address of FET for file 

(X7) Error status if B7 is 0 

Registers used: 

Al, A2, A3, A4. A6, A7 
Bl, B2, B3, B4, B5, B6, B7 
XI, X2, X3, X4, X6, X7 

Calls: 


CIO= 


12.2.32 COMCXJR - RESTORE ALL REGISTERS WITH A SYSTEM XJR CALL 

COMCXJR restores all registers from a register save area with a system XJR call. The format of the 
registers in the save area is BO, Bl,..., B7, AO, Al,..., A7, XO, XI,..., X7. Each register occupies a full 
word with the B and A register values in bits 17-0. XJR= is the only entry point for COMCXJR. 

Entry conditions: 

(XI) Address of the register save area. 

Exit conditions: 

All registers are set to the contents of the register save area. 

Registers used: 

AO, Al, A2. A3, A4, A5, A6, A7 
BO, Bl, B2, B3, B4, B5, B6, B7 
XO, XI, X2, X3, X4, X5, X6, X7 

12.2.33 COMCZTB -- CONVERT ALL 00 CHARACTERS TO BLANKS 

COMCZTB converts aR 00 characters in a word to blanks. ZTB= is the only entry point for COMCZTB. 
Entry conditions: 

(Bl) 1 

(XI) Word to be converted 

Exit conditions: 

(X6) Converted word 

(X7) Final character mask 

Registers used: 

A3 

X3, X6, X7 
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12.3 MACROS THAT CALL THE COMMON COMMON DECKS 


Entry points in the common common decks can be called by using system macros. Table 12-3 shows which 
macros call entry points in the common common decks. AU of the macros are supported under NOS and 
NOS/BE. Only the MOVE macro is supported under SCOPE 2. All macros applicable to a given operating 
system exist in the system text CPUTEXT. Each macro is described in detail in the following paragraphs. 


TABLE 12-3. MACROS THAT CALL COMMON COMMON DECKS 


Macro 

Entry Points 
Called 

Description 

MESSAGE 

MSG- 

Displays a message on the system 
console and enters it in a dayfile. 

MOVE 

MVE- 

Moves a block of data from one 
address to another. 

READC 

RDC= 

Reads one coded line from the input/output 
buffer to the working buffer. 

READH 

RDH= 

Reads one coded line with space fill from 
the Input/output buffer to the working 
buffer. 

READO 

RDO- 

Reads one word from the input/output 
buffer to X6, 

READS 

RDS= 

Reads a line image to a character 
buffer. 

READW 

RDW= 

Fills the working buffer from an 
input/output buffer. 

RECALL 

RCL- 

WNB= 

Relinquishes the CPU until a 
function is completed or the CPU 
recall time has elapsed. 

SYSTEM 

SYS- 

Requests the system to process 
any three-character request. 

WRITE C 

WTC= 

Writes a coded line image from the working 
buffer to the input/output buffer. 

WRITER 

WTH= 

Writes a coded line, deleting all 
trailing spaces, from the working 
buffer to the input/output buffer. 

WRITE 0 

WTO= 

Writes one word from X6 to the 
input/output buffer. 

WRITES 

WTS- 

Writes a line image from the 
character buffer. 

WRITE W 

WTW- 

Writes data from the working 
buffer to the input/output buffer. 


60492600 H 


12-27 











































12.3.1 MESSAGE 


MESSAGE displays a message on the system console display and enters it into a day file. If the job is of 
system origin, the message can be flashed on the B display by including a dollar sign as the first character 
of the message. MESSAGE requires the common common deck COMCSYS. 

The maximum length that a message can be is 80 characters; up to 40 characters per line are displayed. 
The message ends with either the first word containing 12 bits of zeros in any byte or at the eightieth 
character. The user must pack the display code message in sequential locations before calling MESSAGE. 

The format of the RA+i call for this macro is: 



59 

40 

35 

23 

17 0 

RA+l 1 

MSG 


r 0 

X 

0 

addr 


Macro format: 


LOCATION 

OPEBATION 

VAKIABIE SUBFIEIDS 


MESSAGE 

addr,x,r 


addr Beginning address of the message. If the upper 12 bits of the location specified by this 

address are zero, then the next 18 bits (47 thru 30) of this location are assumed to contain 
the beginning address of the message. 

X Message routing option: 

0 Message is placed in the system dayfile, the user dayfile, and is displayed at line 1 of 
the control point. 

1 Message is displayed at line 1 of the control point. 

2 Message is displayed at line 2 of the control point. 

3 Message is placed in the user dayfile and displayed at line 1 of the control point. 

4 Message is placed in the error log dayfile if the job is a special system job (that is, has 

an SSJ=entry point) or is of system origin; otherwise, the message is placed in the user 
dayfile. 

5 Message is placed in the account dayfile if the job is a special system job or is of 
system origin; otherwise, the message is placed in the user dayfile. 

6 Message is placed in the system dayfile, the user dayfile, and is displayed at line 1 of 
the control point. 

7 Message is placed in the user dayfile and displayed at line 1 of the control point. 

If X is not specified or is an illegal value, x=0 is assumed. If x is not defined, x=l is 
assumed. If x is the character string LOCAL, x=3 is used. 

r If r is specified, control is not returned until the operation is complete. 
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The control point message areas (lines 1 and 2) provide the user with the ability to display 
concurrently messages that enter the dayfile and those that require operator action. Line 2 is 
normally used to display information about the current status of the executing program. 

Only messages that do not refer to the job, such as the control statements processed and compilers 
used, should be placed in the system dayfile (x=0). AU messages that refer to the job, such as the 
path taken by the programs and the number of records copied, should be placed only in the user 
dayfile (x=3). All messages placed in the user dayfile (x=0 and x=6) are counted by the system. If 
the number of messages issued by the job exceeds the limit for which the user is validated, the error 
message MESSAGE LIMIT; is issued to the user dayfile and the job is aborted. 


12.3.2 MOVE 

MOVE moves a block of data from one address to another. MOVE requires the common common deck 
COMCMVE for absolute assemblies. 

Macro format: 


-, 

LOCATION 1 

OPERATION 

VARIABLE SUBFIEIOS 


MOVE 

count, addrl, addr2 


count Number of words in the block to be moved 
addrl Address of the first word of the block to be moved 
addr2 Address of the first word of the destination 
MOVE allows overlap in data moves (addr2 can be less than addrl plus count). 

12.3.3 READC 

READC reads one coded line from the input/output buffer to the working buffer. Data is transferred until 
the end of the line (0000 in bits 11 through 0) is sensed or until the specified number of words are 
transferred. READC requires the common common deck COMCRDC. 

Macro format: 


LOCATION 

OPERATION 

VARIABLE SUDFIEIOS 


READC 

addr, buf, n 


addr FET address 

buf Working buffer address 

n Working buffer word coimt 
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12,3.4 READH 


READH reads a coded line with space fill from the input/output buffer to the working buffer. Data is 
transferred until the end of the line (0000 in bits 11 through 0) is sensed or until the specified number of 
words are transferred. READH requires the common common deck COMCRDH. 

Macro format: 


LOCATION 

OPERATION 

variable subfields 


READH 

addr, buf, n 


addr FET address 

buf Working buffer address 

n Working buffer word count 


12.3.5 READO 

RE ADO reads one word from the input/output buffer to X6. READO requires the common common deck 
COMCRDO. 

Macro format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 


READO 

addr 


addr FET address 

12.3.6 READS 

READS reads a line Image to a character buffer. The words are unpacked and stored in the working buffer 
right justified, one character per word, until the end-of-byte (0000) is detected. If the coded line 
terminates before the specified number of characters are stored, the working buffer is blank filled. 

READS requires the common common deck COMCRDS. 

Macro format: 


LOCATION 

OPERATION 

VARIABLE SUBFIEIDS 


READS 

addr, buf, n 


addr FET address 

buf Working buffer address 

n Working buffer word count 
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12.3.7 READW 

READW fills the working buffer from an input/output circular buffer. READW reads ahead in the 
input/output buffer. This could cause the program to abort if the last word address of the input/output 
buffer is within four words of the FL. If the word count is greater than the length of the working buffer, 
READW writes beyond the end of the working buffer. READW requires the common common deck 
COMCRDW. 

Macro format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


READW 

addr, buf, n 


addr FET address 

buf Working buffer address 

n Working buffer word count 


12.3.8 RECALL 

RECALL enables the user to relinquish the CPU until a function is completed or the CPU recall time has 
elapsed (delay time depends on the operating system and the site). If the stat parameter is included in the 
call, control is not returned to the program until bit 0 of the word specified by stat is set. If stat is not 
included in the macro call, the program relinquishes the CPU only until the next pass through the recall 
loop. RECALL requires the common common deck COMCSYS. 

The format of the RA+1 call for this macro is: 



59 

40 

17 0 

RA+1 1 

RCL 

1 

r 0 

Stat 


Macro format: 


LOCATION 

OPERATION 

VARIABLE 5UBFIEL0S 


RECALL 

stat 


stat If this parameter is present, control is returned to the program when bit 0 of the word specified 
by the address stat is set. 
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12.3.9 SYSTEM 


SYSTEM processes a three-letter request. The request can be either the functions that MTR performs or a 
PP program. A PP program can be called from a CPU program if the first character of the name is 
alphabetic. SYSTEM requires the common common deck COMCSYS. 

The format of the RA+1 call for this macro is: 


59 40 35 17 0 



Macro format: 


LOCATION 

OPERATION 

VARIABLE 5UBPIELDS 


SYSTEM 

req,r,pl,p2 


req Three-character system request 


r If specified, control is returned only after the request is completed 
pi Bits 17 through 0 of the request 
p2 Bits 35 through 18 of the request 

12.3.10 WRITEC 

WRITEC writes a coded line image from the working buffer to the input/output buffer. Data is transferred 

(OOOO in bits 11 through 0) is sensed. WRITEC requires the common common deck 

COMCWXC. 

Macro format: 


LOCATION 

OPERATION 

VARIABLE SUBfIELDS 


WRITEC 

addr,buf 


addr FET address 

buf Working buffer address 
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12.3.11 WRITEH 


WRITEH writes a coded line, deleting all trailing spaces, from the working buffer to the input/output 
buffer. WRITEH requires the common common deck COMCWTH. 

Macro format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


WRITEH 

addr, buf, n 


addr 

FET address 

buf 

Working buffer address 

n 

Working buffer word count 

12.3.12 WRITEO 


WRITEO writes one word from X6 to the input/output buffer. WRITEO requires the common common deck 
COMCWTO. 

Macro format: 


LOCATION 

Operation 

VARIABLE SUBFIELDS 


WRITEO 

addr 


addr FET address 

12.3.13 WRITES 

WRITES writes a line image from the working buffer. Characters are packed ten characters per word. 
Trailing spaces are deleted before the characters are packed. WRITES requires the common common deck 
COMC^S. 

Macro format: 


LOCATION 

OPERATION 

VARIABLE SUBFIELDS 


WRITES 

addr, buf, n 


addr FET address 

buf Working buffer address 

n Working buffer word count 
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12.3.14 WRITEW 


WRITEW writes data from the working buffer to the input/output circular buffer. WRITEW writes ahead in 
the input/output buffer. This could cause the program to abort if the last word address of the input/output 
buffer is within four words of the FL. If the word count is greater than the length of the working buffer, 
WRITEW reads beyond the end of the working buffer. WRITEW requires the common common deck 
COMCWTW. 

Macro format: 


LOCAUON 

OPERATION 

VARIABLE SUBFIEIDS 


WHITEW 

addr, buf, n 


addr FET address 

buf Working buffer address 

n Working buffer word count 


12-34 
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CHARACTER SETS 


A 


NOTES 

1. The terms upper case and lower case apply only to the case conversions, and 
do not necessarily reflect any true case. 

2. When translating from display code to ASCIl/EBCDrc the upper case equivalent 
character is taken. 

3. When translating from ASCIl/EBCDIC to display code, the upper case and lower 
case characters fold together to a single display code equivalent character. 

4. All ASCII and EBCDIC codes not listed are translated to display code 55 (space). 

5. Where two display code graphics are shown for a single octal code, the leftmost 
graphic corresponds to the CDC 64-character set (system assembled with IP CSET 
set to C64.1), and the rightmost graphic corresponds to the CDC 64-character 
ASCII subset (system assembled with IP CSET set to C64.2). 

6. In a 63-cbaracter set system, the display code for the ; graphic is 63. The % 
character does not exist, and translations from ASCn/EBCDIC % or ENQ yield 
blanlt (55g)* The display code value 00 is undefined in 63-character set systems. 

7. Twelve or more zero bits at the end of a 60-bit word are interpreted as an 
end-of-line mark rather than two colons. An end-of-line mark is converted to 
external BCD 1632 and internal BCD 1672 by operating systems when writing 
7-track magnetic tape in even parity (coded) mode, and converted back to 0000 
when reading. 

8. This code is changed to 12 when written on a 7-track magnetic tape in even 
parity (coded) mode. 

9. 11-0 and 11-8-2 are equivalent on input. The character will be pimched as 

11- 0 on output. 

10. 12-0 and 12-8-2 are equivalent on input. The character will be punched as 

12- 0 on output. 

11. 12-8-7 and 11-0 are equivalent on input. The character will be punched as 
12-8-7 on output, 

12. 12-8-4 and 12-0 are equivalent on input. The character will be punched as 
12-8-4 on output. 

13. CODE pseudo selects 6-bit octal code as follows: 

A Ascn 

D Display Code (default) 

E External BCD 

I lhte3mal BCD 
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CODE E 

CODE D (defauU) . CODE ^ 


DIsj 

Co 

Octni 

[7lay 

de 

Char. 

Hollerith 

Punch 

(02G} 

E 

Ext. 

ICD 

Int. 

6-Dit 

Octal 

Up 

Hex. 

por Cast 

Char. 

AS 

Punch 

(029) 

sen 

Hex. 

Lowe 

Char. 

r Case 

Punch 

Upj 

Hex. 

EBC 

per 

Char. 

Die 

Lower 

Jicx. 1 Char, 

1 

( 

00 


8^2 

00® 

12 

32 

3A 

; 

0-2 

lA 

SUB 

9-8-7 

7A 

J 

3F 

-- 

SID 

01 

A 

12-1 

G1 

21 

41 

41 

A 

12-1 

61 

a 

12-0-1 

Cl 

A 

81 

a 

02 

B 

12-2 

62 

22 

42 

42 

B 

12-2 

62 

b 

12-0-2 

C2 

B 

82 

b 

03 

C 

12-3 

63 

23 

43 

43 

C 

12-3 

63 

c 

12-0-3 

C3 

C 

83 

c 

04 

D 

12-4 

64 

24 

44 

44 

D 

12-4 

64 

d 

12-0-4 

C4 

D 

84 

d 

05 

£ 

12-5 

65 

25 

45 

45 

E 

12-5 

€5 

e 

12-0-5 

C5 

E 

85 

e 

OG 

F 

12-6 

66 

2G 

46 

46 

F 

12-6 

66 

f 

12-0-6 

C6 

F 

86 

f 

07 

G 

12-7 

67 

27 

47 

47 

G 

12-7 

67 

g 

X2-0-7 

C7 

G 

87 

g 

10 

H 

12-8 

70 

30 

50 

48 

H 

12-8 

68 

h 

12-0-8 

C8 

H 

88 

h 

11 

I 

12-9 

71 

31 

61 

49 

1 

12-9 

09 

i 

12-0-9 

CD 

1 

89 

1 

12 

J 

11-1 

41 

41 

52 

4A 

J 

11-1 

6A 

j 

12-11-1 

D1 


91 

j 

13 

K 

11-2 

42 

42 

S3 

4B 

K 

11-2 

6B 

k 

12-11-2 

D2 

K 

92 

k 

14 

L 

11-3 

43 

43 

54 

4C 

L 

11-3 

6C 

1 

12-11-3 

D3 

L 

93 

1 

15 

M 

11-4 

44 

44 

55 

4D 

M 

11-4 

6D 

m 

12-11:^ 

D4 

M 

94 

m 

16 

N 

11-5 

45 

45 

56 

4E 

N 

11-6 

6£ 

n 

12-11-6 

D5 

N 

95 

D 

17 

O 

11-G 

46 

46 

57 

4F 

O 

11-6 

6F 

o 

12-11-6 

D6 

O 

96 

0 

20 

P 

11-7 

47 

47 

60 

50 

P 

11-7 

70 

P 

12-11-7 

D7 

P 

97 

P 

21 

Q 

11-8 

50 

60 

61 

51 

Q 

11-8 

71 

q 

12-11-8 

D6 

Q 

98 

q 

22 

H 

11-9 

51 

51 

62 

52 

R 

11-9. 

72 

r 

12-11-9 

D9 

R 

99 

r 

23 

S 

0-2 

22 

62 

63 

S3 

8 

0-2 

73 

8 

U-0-2 

£2 

S 

A2 

8 

24 

T 

0-3 

23 

63 

64 

54 

T 

0-3 

74 

t 

11-0-3 

E3 

T 

A3 

i 

25 

U 

0-4 

24 

64 

65 

55 

U 

0-4 

75 

U 

11-0-4 

E4 

U 

A4 

u 

26 

V 

0-5 

25 

65 

66 

56 

V 

0-5 

76 

V 

11-0-5 

E5 

V 

A5 

V 

27 

w 

0-6 

26 

66 

67 

57 

W 

0-6 

77 

w 

11-0-6 

E6 

W 

A6 

w 

30 

X 

0-7 

27 

67 

70 

58 

X 

0-7 

78 

X 

11-0-7 

E7 

X 

A7 

X 

31 

Y 

0-8 

30 

70 

71 

59 

Y 

0-8 

79 

y 

11-0-8 

E8 

Y 

A8 

y 

32 

z 

0-9 

31 

71 

72 

5A 

Z 

0-9 

7A 

z 

11-0-9 

E9 

Z 

A9 

z 

33 

0 

0 

12 

00 

20 

30 

0 

0 

10 

DLE 

lMl-9-6-1 

FO 

0 

10 

DLE 

34 

1 

1 

01 

01 

21 

31 

1 

1 

11 

DCl 

11-9-1 

FI 

1 

11 

DCl 

35 

2 

2 

02 

02 

22 

32 

2 

2 

12 

DC2 

11-9-2 

F2 

2 

12 

DC2 

36 

3 

3 

03 

03 

23 

33 

3 

3 

13 

DC3 

11-9-3 

F3 

3 

13 

TM 

37 

4 

4 

04 

04 

24 

34 

4 

4 

14 

DC4 

11-9-4 

F4 

4 

3C 

DC4 


A-2 


60492600 A 



CODE D (default) 


T CODE * 

I I CODE A 

1 1 t 


Disp 

Co< 

Octal 

© 

lay 

jc 

Char. 

Hollerith 

Punch 

(02G) 

Ext. 

® 

:d 

tnt. 

® 

6-Bil 

Octal 

® 

Upp 

Hex. 

er Case 

Char. 

Ascn 

Punch 

(029) 

Hex. 

Lower 

Char. 

Case 

Punch 

Up 

Hex. 

EBC 

per 

Char. 

:dic 

La 

Hex. 

wer 

Char. 

40 

5 

5 

05 

05 

25 

35 

5 

5 


NAK 

9-8-5 

F5 

5 

3D 

NAK 

41 

G 

6 

06 

06 

26 

36 

6 

6 

16 

SYN 

9-2 

F6 

6 

32 

SYN 

42 

7 

7 

07 

07 

27 

37 

7 

7 

17 

ETB 

0-9-6 

F7 

7 

26 

ETB 

43 

8 

6 

iO 

10 

30 

38 

8 

B 

18 

CAN 

11-9-8 

F8 

8 

18 

CAN 

44 

9 

9 

11 

11 

31 

39 

9 

9 

19 

EM 

11-9-8-1 

F9 

9 

19 

EM 

45 

+ 

12 

60 

20 

13 

2D 

+ 

12-8-6 

OB 

VT 

12-9-8-3 

4E 

+ 

OB 

VT 

46 

- 

11 

40 

40 

15 

2D 

- 

11 

OD 

CR 

12-9-8-5 

60 

- 

OD 

CR 

47 

* ’ 

11-8-4 

54 

54 

12 

2A 

« 

11-8-4 

OA 

LF 

0-9-5 

5C 

* 

25 

LF 

50 

/ 

0-1 

21 

61 

17 

2F 

/ 

0-1 

OF 

SI 

12-9-8-7 

61 

i 

OF 

SI 

51 

( 

0-8-4 

34 

74 

10 

26 

( 

12-8-5 

06 

BS 

11-9-6 

4D 

( 

16 

BS 

52 

) 

12-8-4 

74 

34 

11 

29 

) 

11-8-5 

09 

HT 

12-9-5 

5D 

) 

05 

HT 

53 

$ 

11-8-3 

53 

S3 

04 

24 

$ 

11-8-3 

04 

EOT 

9-7 

5B 

$ 

37 

EOT 

54 

££ 

8-3 

13 

13 

35 

3D 

= 

8-6 

ID 

GS 

11-9-8-5 

7E 

= 

ID 

IGS 

55 

space 

space 

20 

60 

00 

20 

space 

space 

00 

NUL 

12-0-9-8-1 

40 

space 

00 

NUL 

56 

1 

0-8-3 

33 

73 

14 

2C 

* 

0-8-3 

OC 

FF 

12-9-8-4 

6B 

I 

OC 

FP 

57 


12-8-3 

73 

33 

16 

2E 

. 

12-8-3 

0£ 

SO 

12-9-8-6 

4B 

. 

OE 

SO 

60 

0-8-G 

36 

70 

03 

23 

# 

8-3 

03 

! ETX 

12-9-3 

7B 

# 

03 

1 ETX 

61 

c 

8-7 

17 

17 

73 ' 

‘ SB 

t 

12-8-2 

1C 

FS 

11-9-8-4 

4A 


1C 

IFS 

62 

k 

0-8-2 

32 

72 

76 

SD 

] 

11-8-2 

01 

SOH 

12-9-1 

5A 

I 

01 

SOH 

63 


8-6 

IG 

16 

05 

25 

% 

0-8-4 

05 

ENQ 

0-9-8-5 

6C 

% 

2D 

ENQ 

64 


8-4 

14 

14 

02 

22 

» 

8-7 

02 

STX 

12-9-2 

7F 

It 

02 

STX 

65 

r*— 

0-8-5 

35 

75 

77 

5F 


0-8-5 

7F 

DEL 

12-9-7 

6D 


07 

DEL 

€6 

1 

V I 

11-0® 

52 

52 

01 

21 

I 

12-8-7® 

7D 

1 

11-0 

4F 

I 

DO 

1 

67 

A & 

0-8-7 

37 

77 

06 

26 

& 

12 

06 

ACK 

0-9-8-6 

50 

& 

2E 

ACK 

70 

t • 

11-8-5 

55 

55 

07 

27 

f 

8-5 

07 

BEL 

0-9-8-7 

1 

7D i 

' 

2F 

BEL , 

71 

1 ? 

11-8-6 

5G 

56 

37 

3F 

? 

0-8-7 

IF 

US 

11-9-8-7 

6F 

? 

IF 

lUS 

72 

< 

12-0® 

72 

32 

34 

3C 

< 

12-8-4© 

7B 

1 

12-0 

4C ' 

! 

< 

CO 

1 

73 

> 

11-8-7 

57 

57 

36 

3E 

> 

0-8-6 

IE 

RS 

11-9-8-6 

6E 

> 

IE 

IRS 

74 

< @ 

8-5 

16 

15 

40 

40 


8-4 

60 


8-1 

7C 

@ 

79 


76 

> \ 

12-8-6 

75 

35 

74 

5C 


0-8-2 

7C 

\ 

12-11 

EO 

\ 

6A 

\ 

\ 

76 

^ A 

12-8-6 

76 

36 

76 

5E 

A 

11-8-7 

7E 

rj 

11-0-1 

5F : 


A1 

OJ 

77 

i 

12-8-7 

77 

37 

33 

3B 

■ 

11-8-6 

IB 

ESC 

0-9-7 

5E 

j 

1 

27 

ESC 
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HEXADECIMAL-OCTAL CONVERSION TABLE 


First Hexadecimal Digit 

0 1 1 2 3 

_il l 

I ^ 

5 

L_ 

6 

7 

1 

8 

i 

9 

1 

A 

1 

B 

1 

C 

1 

D 

! 

E 

1 

F 

1 


000 020 040 060 100 120 140 160 200 220 240 260 300 320 340 360 

001 021 041 061 101 121 141 161 201 221 241 261 301 321 341 361 

002 022 042 062 102 122 142 162 202 222 242 262 302 322 342 362 

003 023 043 063 103 123 143 163 203 223 243 263 303 323 343 363 

004 024 044 064 104 124 144 164 204 224 244 264 304 324 344 364 

005 025 045 065 105 125 145 165 205 225 245 265 305 325 345 365 

006 026 046 066 106 126 146 166 206 226 246 266 306 326 346 366 

007 027 047 067 107 127 147 167 207 227 247 267 307 327 347 367 

010 030 050 070 110 130 150 170 210 230 250 270 310 330 350 370 

011 031 051 071 111 131 151 171 211 231 251 271 311 331 351 371 

012 032 052 072 112 132 152 172 212 232 252 272 312 332 352 372 

013 033 053 073 113 133 153 173 213 233 253 273 313 333 353 373 

014 034 054 074 114 1 34 154 174 214 234 254 274 314 334 354 374 

015 035 055 075 115 135 155 175 215 235 255 275 315 335 355 375 

016 036 056 076 116 136 156 176 216 236 256 276 316 336 356 376 

017 037 057 077 117 137 157 177 217 237 257 277 317 337 357 377 

000 - 040- 100- 140 - 200 - 240 - 300 - 340- 

037 077 137 177 237 277 337 377 
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ASSEMBLY-TIME I/O 


B 


SCOPE 2 

COMPASS 3 under SCOPE 2 uses the Record Manager for all of its I/O operations. Thus, COMPASS 3 can 
read and write files with a variety of external formats. For each of the files used by COMPASS, the 
default format, and the combinations of file format description parameters that may be specified in FILE 
control statements to override the defaults, are given below. 


Main Source hiput File 

The main source input file may be a normal source input file or a compressed compile file; COMPASS 
determines which it is by inspecting the data in the fUe. A normal source input file under SCOPE 2 
comprises the following: 

File Organization (FO) sequential (SQ) 

Block Type (BT) unblocked 


Maximum Block Length (MBL) 
Record Type (RT) 

Maximum Record Length (MRL) 
Conversion Mode (CM) 

Label Type (LT) 


none 

control word (W) 
160 characters 
NO 

unlabeled (UL) 


The only other formats that may be specified by FILE control statements are as follows (X means allowed): 


Block 

Type 

Record Type 

F 

w 

z 

unblocked 

X 

X 


C 

X 

X 

X 

I 


X 



File Organization (FO) must be sequential (SQ). 

Maximum Record Length (MRL) must not exceed 160 characters. 

Label Type (LT) may be any value supported by the operating system. 

Although the maximum record length may be as large as 160 characters, only the first 90 characters of 
each record are reproduced in the listing output files. 
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If the file is a compressed compile file (written by UPDATE in X mode or MODIFY in A mode), COMPASS 
sets the file format description parameters to resemble normal input; however, MRL = 5120 characters. 
Modify is not available on SCOPE 2. 


Listing Output Files 

The default format under SCOPE 2 comprises the following: 


File Organization (FO) 

Block Type (BT) 

Maximum Block Length (MBL) 
Record Type (RT) 

Maximum Record Length (MRL) 
Conversion Mode (CM) 

Label Type (LT) 


sequential (SQ) 

unblocked 

none 

control word (W) 
137 characters 
NO 

Unlabeled (UL) 


The only other formats that may be specified by FILE control statements are as foRows (X means allowed): 


Block 

Type 

Record Type 

F 

W 

z 

unblocked 

X 

X 


C 

X 

X 

X 

I 


X 



File Organization (FO) must be sequential (SQ). 

Maximum Record Length (MRL) must not exceed 137 characters. 
Label Type (LT) may be any value supported by the operating system. 


Binary Output File 

FILE control statements can be used under SCOPE 2 to specify the format of binary output files for any of 
the operating systems, such that a program can be assembled under SCOPE 2 and the object program 
executed under a different system if so desired. 


B“2 
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File Characteristics 


SCOPE 2 


NOS and NOS/BE 1 


File Organization (FO) 

Block Type (BT) 

Maximum Block Length (MBL) 
Record Type (RT) 

Maximum Record Length (MRL) 
Conversion Mode (CM) 

Label Type (LT) 


sequential (SQ) 

unblocked 

none 

control word (W) 
1,310,710 chars. 
NO 

Unlabeled (UL) 


sequential (SQ) 
character count (C) 

5120 chars. 

system-^logical-record (S) 

none 

NO 

ANY 


No other formats are allowed, except that the label type (LT) can be any value supported by the operating 
system used for assembly. The format shown above under SCOPE 2 is the default binary output file format 
under that system. 


Scratch Files 

COMPASS uses two scratch files named ZZZZZRL and ZZZZZRM, when table storage space overflows. 
Regardless of what is specified by FILE control statements, COMPASS sets the file format description 
parameters for these files under SCOPE 2 as follows: 

File Organization (FO) = sequential (SQ). 

Conversion Mode (CM) = NO. 

For fUe ZZZZZRL: 

Block Type (BT) = unblocked. 

Maximum Block Length = 5120 characters. 

Record Type (RT) = undefined (U) Maximum Record Length = 2550 characters. 

For ffle ZZZZZRM: 

Block Type (BT) = character count (C), Maximum Block Length = 5120 characters. 

Record Type (RT) = SCOPE logical (S), no Maximum Record Length. 


ALL OPERATING SYSTEMS 
System Text Input Files 

A user library file designated by an S parameter on the COMPASS control statement must have the 
standard library file format for the system on which COMPASS is being used.'f COMPASS uses the 
operating system overlay loader to access these files. 

For a sequential binary (non-library) file designated by a G parameter on the COMPASS control statement, 
the default and permitted formats are the same as those given above for the COMPASS binary output file. 


^Overlay residence in user libraries is not currently supported by NOS. 
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XTEXT Input Files 


A file read by COMPASS when processsing an XTEXT pseudo instruction can have any of several formats. 
COMPASS determines the file format (a) by whether the XTEXT pseudo instruction variable field is empty 
and (b) by inspecting the data in the file. 

If the variable field is empty, the File Organization (FO) must be sequential (SQ). COMPASS rewinds the 
file and reads until end of section or a COMPASS END statement is encountered, whichever comes first. 
The default and permitted formats under SCOPE 2 are the same as those given above for the main source 
input file. 

If the XTEXT variable field is non-empty, the file organization can be any of three non-standard types: 
Record indexed with name index (under SCOPE 2 only). 

SCOPE 3.3 style random file with name index (not supported under SCOPE 2), 

Update or Modifyt random program library file. 

In each case, COMPASS sets the file format description parameters to the appropriate values; no FILE 
control statement is needed. 


The record indexed file organization is actually the word addressable (WA) file organization with a set of 
f ormat conventions superimposed on it. Such a file can be created by a FORTRAN program by using the 
library subroutines OPENMS, STINDX, WRITMS, and CLOSMS with a name index, or by a COBOL program 
specifying ORGANIZATION IS WORD-ADDRESS, WORD-ADDRESS IS data-name. When COMPASS detects 
such a file under SCOPE 2, it sets the file format description parameters as follows (no FILE card is 
needed): 

File Organization (FO) = word addressable (WA). 

Block Type (BT) = unblocked. 

Record Type (RT) = control word (W); Maximum Record Length (MRL) = 160 characters. 

Conversion Mode (CM) NO. 

COMPASS positions the file at the record pointed to by the index entry containing the name given in 
the XTEXT statement variable field, and then reads records sequentially until end of section or a 
COMPASS END statement is encountered, whichever comes first. 

The SCOPE 3.3 style random file with name index is permitted for compatibility with previous versions of 
COMPASS. When COMPASS detects such a file, it searches the file index and positions the file at the 
beginning of the specified section, and then reads sequentially until end of section or a COMPASS END 
statement is encountered, whichever comes first. Such files cannot be used with SCOPE 2. 

An Update or Modify^ random program library file is processed similarly. The name in the variable field of 
the XTEXT statement must be the name of a common deck. When COMPASS detects such a file under 
SCOPE 2, it sets the file format description parameters as follows (no FILE control statement is needed): 


^Modify is not available under SCOPE 2 or NOS/BE 1. 
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File Organization (FO) = word addressable (WA). 

Block Type (BT) - unblocked 

Record Type (RT) = control word (W), Maximum Record Length (MRL) = 5120 characters 
Conversion Mode (CM) == NO 

COMPASS positions the file at the first card image of the designated section (common deck). For 
an UPDATE program library, the first active card image (the *COMDECK card) is skipped. 
COMPASS then reads card images sequentially, ignoring inactive card Images, until end of section 
or a COMPASS END statement is encountered, whichever comes first. 
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BINARY CARD FORMATS 


C 


Column 1 


7, 8,9 levels 0 to 16 

6.7.9 

6,7,8, 9 or 7,8,9 level 17 

7.9 

7 and 9 not both In column 1 


End-of-section 
End-of-partltlon (NOS only) 
End-of-information 
Binary card 
Coded card 



1 

y— 

2 

3 

4 

5 








12 








1 






11 














0 

*d 


<- 


— 

— 

■ Column Binary Information - 





T3 


1 

5 

o 










0 

to 

€ 


2 

'2 

o 

o 

1 





____j 





3 

u 

0 

n 

3 






---1 






j 

4 











0 

01 


0 

5 
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A binary card can contain up to 15 60-bit CPU words starting at column 3. Column 1 also contains 
a count of 60-bit words in rows 0, 1, 2, and 3plus a check indicator in row 4. If row 4 of column 1 is 
zero, column 2 is used as a checksum for the card on input; if row 4 is one, no check is performed on 
input. 

Column 78 of a binary card Is not used, and columns 79 and 80 contain a binary serial number. If a 
section is punched, each card has a checksum in column 2 and a aerial number in columns 79 and 80, 
which sequences it within the logical record. 
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HINTS ON USING COMPASS 


1. Within a macro definition: 

Use comment statements having * in column one* These are not saved, whereas other types of 
comments are saved. 

Whenever possible, minimize the number of lines of code. 

IRP is faster than either ECHO or DUP. 

Use the substitute parameter flags ;A, ;B, and so forth, for macros, to avoid a second line. 

Within macros, use symbols such as .1, .2, and so forth, instead of local symbols. 

If possible, avoid recursive macro structure to increase assembly speed. 

If a macro call is the cause of an error, direct full list output to a file other than OUTPUT 
(L=^ilename) to obtain a list of the erroneous macro call with the error listing. 

2. hi IF sequences: 

Use line counts rather than ENDIF to terminate sequences. 

Use SKIP rather than IFPP to skip code. 

3. Micros: 

Micro replacement is time-consuming. 

Avoid using local symbols for micros. 

Use ^ for a null substitution. 

4- Minimize SYSTEXT size. 

5. To reduce core requirements, use SEG statements in absolute programs. 

6. Use NOREF for symbols for which listing is not required. 

7. Use QUAL for all overlays. 

The program EXAMPLE (figures D-l and D-2) presents fundamental program organization. It also 
demonstrates some COMPASS coding conventions and illustrates efficient coding practice. The program 
obtains numbers from six successive locations, adding the numbers one at a time to the running sum. The 
total is then printed with a labeL 
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Figure D-1. Example COMPASS Program (NOS and NOS/BE) 
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Figure D-2. Example COMPASS Program (SCOPE 2) 


















One of the main considerations in assembly language programming is the reduction of execution time. The 
instruction repertoire of COMPASS often allows an operation to be coded in several ways. The 
programmer, therefore, should give careful consideration to the instructions used in the program to 
perform specific functions. 

Line 1. The ID ENT pseudo instruction is always the first instruction in a program. It specifies a 
program name (EXAMPLE, in this case) to identify the program to the assembler. 

Line 2. The ENTRY pseudo instruction declares the point in the program at which execution is to 
begin. The main entry point in a program is the control transfer address. 

Line 3. NOS and NOS/BE - figure D-1. The BSS instruction establishes the output buffer OBUF. The 
programmer has allocated 301 g words of storage for the buffer, as shown in the assembled octal 
code listed to the left of the source code. Note that the octal code format for the pseudo instructions 
will differ from the format for the symbolic machine instructions because pseudo instructions do not 
have single machine instruction equivalents. 

Line 4. NOS and NOS/BE - figure D-1. The operating system macro FILEC is called to create a file 
environment table (FET) for the output buffer. Only the first word of the FET is shown in the octal 
code, but examination of the location addresses reveals that the table is actually five words in length 
(the minimum length of a FET). For more information about FETs, see the appropriate operating 
system reference manual. 

SCOPE 2 - figure D-2. The FILE macro is used to establish a file information table (FIT) for the 
output buffer. 

Line 5. The first executable line of code has been designated the main entry point for the program. 
Incrementing by one occurs so often within a program that it has become a COMPASS coding 
convention for register B1 to always be initialized to one, and to remain one throughout the entire 
program. This is particularly important during the use of the common common decks (chapter 12), and 
can be a factor in execution time (see Bl=l pseudo instruction) as well as in assembly time. 

Line 6. A counter is initialized to zero by setting the contents of a B register (chapter 8) equal to the 
contents of the BO register. BO is hard-wired to zero, thereby avoiding the need for repeated 
processing of the literal or constant zero. 

Line 7. Comparing the octal code for lines 6 and 7, the programmer can see the difference between 
two forms of register-setting instructions. The 15-bit form of the instruction is used in line 6, where 
only three bits are required to represent the BO register as the source of an operand. The 30-bit form 
of set B register instruction is required for line 7, where the constant 6 is represented by the lower 18 
bits of the instruction. 

Line 8. The mask instruction is normally used to extract fields from a register. Here, it is used 
instead of the slower set X register instruction to initialize an X register. 

Another important feature of COMPASS is illustrated here. The octal code seems to indicate that the 
lower 15 bits of the current word in memory have been left blank. This is the result of a force upper. 
The next instruction is too large to fit in the remaining 15-bit parcel, so COMPASS packs that parcel 
with a no-operation instruction. The next instruction is placed at the beginning of the next word (see 
section 8.1). 

Line 9, The use of the set A register instruction to obtain a word of data is demonstrated here. As 
seen in the octal code, the address of the word (321 q) is placed in the specified A register. The data 
itself is placed in the corresponding X register (X2 in this instance). (See Set A Register Instructions, 
chapter 8.) 

The plus sign (+) after the octal code indicates that the address or K portion of the instruction (the 
lower 18 bits in this case) is relocatable. 
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Line 10. The 15-bit format of the set B instruction is illustrated here. The first six bits contain the 
operation code for the instruction (66g in this instance). The next three bits designate the 
destination register (B2) for the results of the instruction. The next three bits indicate the register 
containing the first source operand (B2). The final three bits indicate the source register for the 
second source operand (Bl). 

Line 11. The number obtained in the previous instruction is added to the running sum kept in XI. This 
is a 60-bit add instruction, as opposed to the SXi instruction, which adds only 18-bit operands. 

Line 12. The NE instruction shows another use of the B registers in testing for a conditional branch. 

In each iteration of the loop, the source operands are compared. While they are unequal, control is 
transferred from this instruction back to LOOP. When the operands become equal, control passes to 
the next instruction. 

Line 13. The return jump (RJ) instruction is used here to access a common common deck, 

COMCCDD, as a relocatable subroutine. The programmer has taken advantage of the COMPASS 
default method of defining external symbols. The =X indicates to the assembler that CDD, the entry 
point to the subroutine, is external to EXAMPLE. 

The use of common common decks is important to the programmer. Note that the decks require 
certain entry conditions. Specific arguments are expected to be in certain registers, for example, 
upon entry to the routines. An efficient program will establish these conditions with a minimum of 
data transfers by using the registers judiciously prior to the caU. COMCCDD, for example, converts 
an octal word to decimal display code; that word is expected to be in register XI. For this reason, the 
running total has been kept in XI, avoiding the need for extra data transfers. 

Line 14. The method of storing an operand in memory is illustrated here. Setting register A6 or A7 
to a valid address causes the contents of X6 or X7, respectively, to be stored in the address specified. 
When COMCCDD has converted the word, it places the result in register X6, ready for storage upon 
return to the calling routine. 

Line 15. NOS and NOS/BE - figure D-1. Another method of accessing a common common deck is 
shown here. A call is made to a system macro, WRITER, which utilizes the common common deck 
COMCWTH to write a line from a working buffer to an output buffer. 

SCOPE 2 - figure D-2. The Record Manager macro OPENM is used to open the output buffer in 
preparation for processing. 

Line 16. NOS and NOS/BE - figure D-1. A call is made to the operating system macro WRITER to 
write the contents of the buffer OBUF (with which the system communicates through the FET 
OUTPUT) to the system default output file, also named OUTPUT. (For more information about 
operating system macros, see the appropriate operating system reference manual.) 

SCOPE 2 - figure D-2. The Record Manager macro PUTW is used to transfer data into the output 
buffer. 

Line 17. SCOPE 2 - figure D-2. The Record Manager macro CLOSEM is used to close the output 
buffer and to print its contents. 

Line 18. The operating system macro ENDRUN is called to terminate program execution. 

Lines 19 through 24. DATA pseudo instructions are used here to establish a table comprising six 
consecutive words in memory, starting at location TABLE. The default base mode is base 10 in 
COMPASS (see Mode Control, chapter 4). 

Line 25. DATA is used here to set in memory a display-coded image of the characters specified, for 
use in the output line. Ten 6-bit characters can be stored per word in this fashion. Therefore, more 
than one word is required here, as seen from the location address on the next line. 
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Line 26. One word of memory is reserved for the final sum. This word is labeled ANS. Note that this 
word is not initialized by the BSS instruction. 

Line 27. The symbol LEN is equated with the value of the origin counter minus the address of 
WORDS. This yields the length of the output line specified in line 15. 

Line 28. The SST instruction ensures that symbols from the system texts used by the program are 
defined. 

Lines 29 through 32. These XTEXT pseudo instructions tell COMPASS to search the system-defined 
program library OPL for the common common decks named. Declarations of this type are normally 
grouped together after the end of the executable code for easy reference. 

Line 33. The END instruction signifies the end of the program. Control is released through the 
transfer address at BEGIN. 

The dayfile for the program EXAMPLE as run on NOS is shown in figure D-3. 

The dayfile for the program EXAMPLE as run on NOS/BE is shown in figure D-4. 

The dayfile for the program EXAMPLE as run on SCOPE 2 is shown in figure D-5. 


15.16.00«eXAHPLE» 

I5.18«0C.UCCR# 7641# 0.048KC0S. 

15«18«00» USER statement. 

15•18• 01 • CHARGE statement. 

15ol0.Ol« ATTACH# COMCPL/UN® XXX. 
15*18*02.CaMPASS(S#S»IPTEXTf S«CPUTEXT# X«C0HCPL) 
15-18.09. ASSEHBIY COHPLETE. 523008 CH USED. 
15,18.09. 0.244 CPU SECONDS ASSEMBLY TI»«£. 

15.18.09.L30. 


15.18.IC.UEAD# 

15.16.10. UEPFf 
15.ia.lO«UEHS» 

15.18.IG.UECP# 

15.18.10. AESR# 
15.22.18.UCLP# 7645# 


O.D02KUNS. 

g.014KUNS. 

0.784KUNS. 

0.252SECS. 

2.622UNTS. 

0.256KLNS. 


The parameter xxx is the site-defined NOS user name. 


Figure D-3. DayfUe of EXAMPLE under NOS 
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09.17.2C.EKAHP2P FPO^' 

09.17.2C.IP C0C00320 WORDS - PILE INPUT . DC CA 
09.17,20.EXAMPLE. 

09.17.2C.ACCOUNT statement. 

09,17.23.ATTACH,COMCPLilO* yyy. 

09.17.23.PFN IS 
09.17.23.C0MCPL 
09.17.2A,at CY» 001 SN-PFOSFT 

09.in.3A.C0MPASS(S,S-IPTEXt»S-CPUTEXT,X-COMCPL) 
09.10.51, ASSEMBLY COHOLETE. E7600B CM USED. 
09.IP.51. 3.A93 CPU SECONDS ASSEMBLY TIME. 


09.1U.51.LGO 
09.16.51.DP 
09.16.51.MS 
09.16.52,CPA 
09.16.52.CPR 
09.18.52.10 
09.16.52.CM 
09.16.52.SS 
09.16.52.PP 
09.16.52.EJ 


CCCC102A WORDS - 
350A WORDS C 

1. A97 SEC. 

2. >61 SEC. 
.A95 SEC. 

121,287 KWS, 

4.649 SEC. 
END OF JPB, ** 


FILE OUTPUT , DC 4C 
7166 MAX USED! 
1.497 ADJ. 
2.261 ADJ. 

.495 ADJ. 
7.402 ADJ. 
11.656 

DATE 02/06/81 


The value yyy is the site-defined ID under which COMCPL has 
been catalogued. 


Figure D-4. Dayfile of EXAMPLE under NOS/BE 













15.50.32 

15.50.32 

15.50.33 
15.50.33 
15.50.33 

15.50.33 

15.50.34 
15.50.34 
15.50.34 
15.50.34 

15.50.34 

15.50.35 
15.50.35 
15.50.35 
15.50.35 
15.50.35 
15.50.35 
15.50.35 
15.50.35 
15.50.35 
15.50.35 
15.50.35 
15.50.35 
15.50.35 
15.50.35 0OCOO.324 HFZ 


15.50.35 00000.326 HFZ. RHS 

15.50.35 00000.326 HFZ. USER 

15.50.35 00000.326 HFZ. JOB 

15.50.35 C0C00.326 HFZ. SC050 


FLS REQUIRED TO LOAD - 0007771 OU.COG 


EXECUTION INITIATED OS.EXP 
HAXIHUH USER SCM 70500B WORDS 

HAXIHUH USER LCH 40000B WORDS 

HAXIHUH JS+IO LCH 35B BUFFERS 

HAXIHUH ACTIVE FILES 2 

OPEN/CLOSE CALLS 19 

DATA TRANSFER CALLS 374 

CONTRQL/POSITIONING CALLS R 

BH DATA TRANSFER CALLS 258 

BH CONTPDL/POSITIDNING CALLS 67 

QUEUE MANAGER CALLS 62 

RECALL CALLS 61 


7.CAB KWS 
3.463 KWS 
0.004 HW 
0.003 HWS 
0.198 SEC 
0.326 SEC 
000015 SC/LC SWAPS 


00000.003 HFZ. -EXAMPLE^ST$C2. 

C0C0C.004 JOB. >ACCQUNT*statement. 

00000.039 JOB. -ATTACH»CaNCPL>IO-zzz. 

00000.039 HFZ. PF053 - LPN IS COHCPL 

00000.043 HFZ. PF254 - CYCLE 1 ATTACHED FROM SN-SYSTEM 

00000.043 LOO. -COHPASSCS*S»IPTEXT»S«CPUTEXT#X-COMCPL) 
C0000.306 USR. ASSEMBLY COMPLETE. 56000B SCH USED. 

0000C.306 USR. 0.249 CPU SEC. 34100B LCH USED. 

00000.306 LDP. -LGO. 

0000C.320 HFZ. LD610 

00000.321 HFZ. L0603 

C0000.323 HF7. JM166 

00000.324 HFZ. JH167 

OOCOC.324 HFZ. JH170 

00000.324 HFZ. RM770 

00000.324 HFZ. RH771 

C0000.324 HFZ. RM772 

flOCOO.325 HFZ. RM773 

OOCO0.325 HFZ. RH774 

00000.32*= HFZ. RM775 

00000.325 HFZ. RH776 

00000.325 HFZ, RH777 

00000.325 HFZ, SCH 

00000.326 HFZ. LCH 

I/O 


The value zzz is the site-defined ID under which COMCPL has been catalogued. 


Figure D-5. DayfUe of EXAMPLE under SCOPE 2 
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DAYFfLE MESSAGES 


E 


The dayfile messages that can be issued by COMPASS are listed in table E-1. 

The following message, with xxxxxxx denoting the name of the subprogram being assembled, is displayed at 
the system operator's console only; it is not written to the dayfile. COMPASS updates the display when¬ 
ever it processes an IDENT statement with a non-blank variable field. 

ASSEMBLING xxxxxxx 


TABLE E-1. DAYFILE MESSAGES 


Message 

Significance 

Action 

ASSEMBLY ABORTED - ECS READ ERROR. 

This message can occur only 
when the job has an ECS field 
length and is used on a CYBER 
180 or a CYBER 170 or CYBER 

70 Model 71, 72, 73, or 74. 
COMPASS may store some of 
its internal tables in ECS» 
When an ECS error persists 
through four attempts to 
read the data, the message 
is issued, and the job is 
aborted^ For the CYBER 70 
Model 76, LCM errors are 
handled by the operating 
system. 

Rerun job. If 
condition persists, 
contact a system 
analyst. 

ASSEMBLY ABORTED - ECS WRITE ERROR. 

This message can occur only 
when the job has an ECS field 
length and is used on a CYBER 
180 or a CYBER 170 or CYBER 

70 Model 71, 72, 73, 74- 
COMPASS may store some of 
its Internal tables in ECS- 
When an error occurs In 
writing data to ECS, no retry 
attempt is made. The message 
is issued, and the job Is 
aborted. For the CYBER 70 
Model 76, LCM errors are 
handled by the operating 
system. 

Rerun job. If 
condition persists, 
contact a system 
analyst. 
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TABLE E-1. DAYFILE MESSAGES (Contd) 


Message 


Significance 


ASSEMBLY ABORTED - PASS n TABLE 
OVERFLOW ASSEMBLING xxxxxxx 


AS SEMBLY COMPLETE. nnnnnnB 


fCM 1 
\ SCM / 


xxxx.xxx CPU 


SECONDS ASSEMBLY TIME. 


SEC.nnnnnnB 


rEcsi 

ILCM / 


While processing the program 
indicated by xxxxxxx> an 
irrecoverable table overflow 
condition has occurred in 
assembly pass n (1 or 2). 
COMPASS allocates memory 
space dynamically to all of 
its internal tables. If one 
table overflows, they all do. 
When the tables do not fit in 
the available SCM space, 
COMPASS will request addi¬ 
tional central memory up to a 
threshold at which time the 
intermediate file and cross- 
references are dumped to mass 
storage scratch files. If 
table space is still inade¬ 
quate, COMPASS will request 
additional central memory up 
to the maximum available to 
the job. When insufficient 
SCM exists after all such 
possibilities have been 
exhausted, COMPASS issues the 
message and aborts the job. 


If COMPASS did not detect any 
fatal errors during assembly, 
this message is issued at the 
completion of processing of 
all source programs on the 
input file. The minimum 
field length needed to per¬ 
form the assemblies success¬ 
fully is the octal number of 
SCM words, nnnnnn. If this 
number is larger than the 
actual field length, it is 
the minimum field length 
needed to avoid lost refer¬ 
ences. The second line of 
the message can be suppressed 
by an installation parameter; 
xxxx.xxx represents the total 
central processor time, in 
seconds, used by COMPASS. 

If any ECS/LCM space was 
assigned to the job, nnnnnn 
is the octal number of words 
used. 



Action 


Rerun job inserting 
an RFL statement 
specifying suffi¬ 
cient field length 
to assemble. 


No action required- 
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TABLE E-l. DAYFILE MESSAGES (Contd) 


Message 

Significance 

Action 

( CM 1 

ASSEMBLY ERRORS. nnnnnnB < > USED. 

(seconds ASSEMBLY TIME. 1 

xxxx.xxx CPU J /ECS ) / 

1 SEC. nnnnnnB < USED. j 

If COMPASS detected at least 
one fatal error during assem- 
bly, this message is issued 
at the completion of proces¬ 
sing of all source programs 
on the input file. If the A 
option was specified on the 
COMPASS control statement, 
the job is aborted after this 
message is issued. The mini¬ 
mum field length needed to 
perform the assemblies suc¬ 
cessfully is the octal number 
of SCM words, nnnnnn. The 
second line of the message 
can be suppressed by an 
installation parameter; 
xxxx.xxx represents the total 
central processor time, in 
seconds, used by COMPASS. 

If any ECS/LCM space was 
assigned to the job, nnnnnn 
is the octal number of words 
used. 

Correct the fatal 
errors and 
reassemble. 

BAD CONTROL STATEMENT ARGUMENT - xx 

The COMPASS control statement 
contains an unrecognized or 
invalid argument. The 
offending argument is named 
in the message. 

Refer to chapter 10 
of this manual to 
correct the COMPASS 
control statement. 

CANT LOAD C0MP3$ 

The operating system loader 
reported a fatal error when 
COMPASS attempted to load its 
primary overlay. This mes¬ 
sage should be preceded by an 
explanatory message from the 
loader. 

Refer to the loader 
diagnostics in the 
loader reference 
manual for informa¬ 
tion about the 
specific loader 
error. 

COMPASS MEEDS AT LEAST nnnnnB SCM. 

The SCM field length for the 
job is too small for COMPASS. 
The number of octal words 
needed by COMPASS before it 
can begin processing is 
nnnnnn. This number varies 
depending on the version of 
COMPASS used and the listing 
and binary output options 
specified on the control 
statement. It is an absolute 
minimum number of words; it 
does not include whatever 
space may be required for 
system text, local macro and 
micro definitions, and so 
forth. 

Rerun job inserting 
an RFL statement 
specifying suffi¬ 
cient field length. 
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TABLE E-1. DATfFILE MESSAGES (Contd) 


Message 

i 

Significance 

i 

Action 

nnnnnnnnn ERRORS IN xxxxxxx 

COMPASS issues this message 

Correct the fatal 


for each source program in 

errors and 


which fatal errors are de¬ 
tected; nnnnnnnnn is the 
number of errors and xxxxxxx 
is the sub-program name. 

reassemble. 

FILE USE CONTRADICTION. 

Control statement specifies 

Correct contra- 


the same file name for two or 
more of the following: 

Source input 

List output (full or short 
list) 

Binary output 

XTEXT source 

diction. 

IDENT STATEMENT MISSING. 

COMPASS issues this message 

Correct the source 


for each source program in 

program to include 


which an END statement is 

an IDENT and END 


encountered before an IDENT 

statement for each 


statement is found. This is 
a fatal error. 

subprogram. 

IMPROPER SYSTEM TEXT FORMAT. 

A system text overlay does 

Correct the internal 

BAD SYSTEM TEXT - x=yyyyyyy/ 2 zzzzzz 

not have the internal format 

format of the system 


required by this version of 
COMPASS. This may be caused 
by a system error- COMPASS 
ignores the bad overlay but 
does not abort the job. The 
expressioni x=yyyyyyy/ 
zzzzzzz, identifies the 
offending overlay in the same 
form in which it is specified 
in the COMPASS control state¬ 
ment; it may be any of the 
following: 

text overlay- 



G-filcname 

G=filename/overlay 

S-overlay 

S-library/overlay 


INPUT FILE EMPTY OR MISPOSITIONED. 

When attempting to read the 
first line from the source 
input file, COMPASS encoun¬ 
tered end of data and 
aborted. 

Correct the name of 
the source input 
file or reposition 
the file. 

INPUT FILE RECORD TYPE NOT ALLOWED. 

The record type of the 
source input file is not 
allowed. COMPASS aborts 
the job step. 

Convert source input 
to acceptable record 
type. 
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TABLE E-1. DAYFILE MESSAGES (Contd) 


Message 

Significance 

Action 

INSUFFICIENT STORAGE FOR SYSTEM TEXT. 

BAD SYSTEM TEXT - x=yyyyyyy/z 2 zzzzz 

When an irrecoverable table 
overflow occurs, COMPASS 
issues this message before 
the first assembly is begun. 

It does not abort the job 
step. The expression, 
x=yyyyyyy/zz 2 zzzz, identifies 
the system text being loaded 
at the time. 

Increase the SCM 
field length for the 
job. 

nnnnnB LCM NEEDED TO CONTINUE. 

The specified amount of 
memory (nnnnnB) is required 
for the job to complete. The 
job step is aborted. 

Increase the LCM 
field length for the 
job. 

nnnnnnnnn LOST REFERENCES IN xxxxxxx 

1 

The symbolic cross-reference 
table is sorted before it is 
printed. If the table does 
not fit in the job’s SCM 
field length for sorting, 
COMPASS discards some of the 
references. A message is 
issued; nnnnnnnnn is the num¬ 
ber of references discarded, 
and xxxxxTcx is the subprogram 
name. The job step is not 
aborted. The ASSEMBLY 

COMPLETE message gives the 
field length needed to avoid 
lost references. 

Increase the SCM 
field length for the 
job. 

MORE THAN 7 SYSTEM TEXTS SPECIFIED. 

COMPASS issues this message 
and aborts the job step, when 
the G and S parameters on the 
COMPASS control statement 
specify a total of more than 
seven system text overlays. 

Restructure the job 
to reduce the number 
of system text over¬ 
lays required. 

NO CONTROL STATEMENT TERMINATOR. 

Before finding a parenthesis 
or period not in a $-delimi- 
ted string, COMPASS read con¬ 
tinuation control statements 
and encountered an end-of- 
section. This is not a fatal 

error. 

Correct the control 

statement. 
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TABLE E-1. DATFILE MESSAGES (Contd) 


Message 

Significance 

Action 

RECURSION DEPTH EXCEEDED 400. 

COMPASS maintains a pushdom 
stack for source input con¬ 
trol. This stack has one 
entry for each active DUP, 
ECHO, HERE, 3CTEXT, or macro 
call. The maximum depth of 
the stack is set by an 
installation parameter; it is 
400 in the released system. 
When this limit is exceeded, 
COMPASS sets a fatal error 
and clears the stack. The 
next statement can then be 
read from the source input 
file. The job step is not 
aborted. This error is usu¬ 
ally caused by a source pro¬ 
gram in which a macro calls 
itself indefinitely. 

Correct the macro 
call program error. 

SYSTEM TEXT NOT FOUND. 

BAD SYSTEM TEXT ~ x“yyyyyyy/zzzzzzz 

When it cannot load the sys¬ 
tem text overlay identified 
by x=yyyyyyy/zzzzzzz, COMPASS 
issues this message. It does 
not abort the job step. For 
an overlay loaded from a 
library file (S parameter), 
this message should be pre¬ 
ceded by an explanatory 
message from the operating 
system loader. For an over¬ 
lay loaded from a non-library 
file {G parameter), COMPASS 
could not find the overlay on 
the file. 

For an overlay 
loaded from a 
library file, refer 
to the diagnostics 
in the loader refer¬ 
ence manual. For an 
overlay loaded from 
a non-library file, 
check that the over¬ 
lay name is speci¬ 
fied correctly and 
that the overlay is 
located on the file. 

nnnnnnnnn WARNING MESSAGES IN xxxxxxx 

COMPASS issues this message 
for each source program in 
which nonfatal errors are 
detected; nnnnnnnnn is the 
number of errors, and xxxxxxx 
is the subprogram name. 

Correct the non¬ 
fatal errors and 
reassemble. 
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GLOSSARY 


F 


Absolute Block - 

A block of object code generated in an absolute assembly. The ABS pseudo instruction is used to 
declare a program absolute. 

Assembler - 

A computer language that prepares an executable program from a source language program by 
substituting machine operation codes for symbolic operation codes and absolute or relocatable 
addresses for symbolic addresses. 

Blank Common Block - 

A common block into which no data is stored at load time- The first declaration of a blank common 
block need not be the largest declaration for the common block. 

Block - 

A grouping of words of object code or storage within a subprogram for a specific purpose. 

Capsule - 

A relocatable collection of one or more programs bound together in a special format that allows the 
programs to be loaded and unloaded dynamically to form an executing program by the Fast Dynamic 
Loading facility- 

central Processor Unit (CPU) - 

The high-speed arithmetic unit that performs the addition, subtraction, multiplication, division, 
incrementing, logical operations, and branching instructions needed to execute programs. 

Comment Line - 

A statement providing documentary information for a section of code. Comment lines are indicated 
by either an asterisk in column 1 or blanks in columns 1 through 29, and are listed but not otherwise 
processed by the assembler. 

Comments Field - 

The field in a COMPASS statement providing documentary information for the statement. It is listed 
but not otherwise processed by the assembler. This field begins with the first nonblank character 
following the vari^le field, or in column 30 if the variable field is blank. 

Common Block - 

An area of memory that can be declared by more than one subprogram and used for storage of shared 
data. 

Constant - 

An e^^ression element consisting of a value represented in octal, decimal, hexadecimal, or character 
notation. 

Data Item - 

A type of character or numeric value that can be used in subfields of the DATA and LIT instructions, 
and as specifications of field lengths on VFD pseudo instructions- 

Entry Point - 

A location within a subprogram that can be referenced from other subprograms. Each entry point has 
a name with which it is associated. 
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External Reference - 

A reference in one subprogram to an entry point in another subprogram. 

Force Upper - 

To guarantee that an instruction begins on a word boundary by packing the parcels remaining in a 
partially completed word with no-op instructions and beginning to assemble the specified instruction in 
the next word. The assembler automatically forces upper in some cases, and the user program can 
specify that a given instruction be forced upper. 

Labeled Common Block - 

A common block into which data can be stored at load time. The first program declaring a labeled 
common block determines the amount of memory allocated. 


Linking - 

The process of matching external references to entry points of the same names and inserting the 
addresses of the entry points into the external references. 

Literal - 

A read-only constant. Conventionally, it is the only element in an expression. Literals are stored in 
the program's literals block to avoid duplication of read-only data. 

Literals Block - 

A block of literal data entries local to a subprogram. 

Load Sequence - 

One or more consecutive control statements processed by the loader as a unit. A load sequence can be 
a single name call statement, or it can consist of loader statements (such as LOAD and LDSET) that 
are terminated by NOGO, EXECUTE, or a name call statement. 

Local Block - 

A storage area defined by a USE or USELCM pseudo instruction. 

Location Counter - 

Normally the same as the origin counter. Can be reset by the programmer to relocate code or data 
without affecting relative positions within the block. 

Location Field - 

The first field in a COMPASS statement, usually providing a name for the address of the instruction or 
for the entity defined by the statement. The location field begins in column 1 or 2. 

Machine Instruction - 

A string of bits capable of being interpreted directly by a central processor or peripheral processor as 
an instruction to perform some operation. 

Macro - 

A sequence of source statements that are saved and then assembled whenever needed through a macro 
calL 

Micro - 

A character string identified by a symbolic name. Wherever the name is encountered in the program, 
the character string is substituted, 

OPDEF - 

A sequence of source statements that are saved and then assembled whenever needed through an opdef 
calL Differs from a macro in that the assembler interprets the call by examining the format or syntax 
of the instruction rather than the contents of the operation field alone. 
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Operation Code - 

A mnemonic operator, used in the operator field of a COMPASS statement, to indicate a specific 
machine instruction. 

Operation Field - 

The field in a COMPASS statement indicating the operation to be performed. It begins with the first 
nonblank character following the location field; or, if the location field is blank, it begins with the 
first nonblank character after column 2. 

Origin Counter - 

A pointer indicating the relative location of the next word to be assembled or reserved in a given block. 
Overlay - 

One or more relocatable programs that were relocated and linked together into a single absolute 
program. 

Parcel - 

One of the 15-bit sections of a central memory word. A CPU machine instruction occupies one, two, 
or four parcels. 

Peripheral Processor Unit (PP or PPU) -- 

An individual computer with its own memory, used for high-speed transfer of information (input and 
output) between peripheral devices and central memory. 

Position Counter - 

A pointer indicating the bit position within the word of the next item to be assembled in a given block. 
Program - 

One or more subprograms capable of being executed as a unit. 

Pseudo Instruction - 

An assembler-defined instruction appearing in the operation field of a statement. It normally does not 
specify the assembly of a single machine instruction, but instead specifies some other assembly 
process (such as symbol definition, listing control, and so forth). 

Qualified Symbol - 

A symbol defined when a qualifier is in effect during assembly. Through qualification, the same 
symbol can be referred to in different subprograms without conflict. 

Reference Address (RA^) and (RAe) - 

RAc is the absolute central memory address that is the starting or zero relative address assigned to 
a program. Addresses within the program are relative to RA. RAg is the absolute extended memory 
starting address assigned to a program- 

Register - 

A unit within the central processor used to hold operands. The A registers contain the addresses of 
words within central memory; the X registers contain operands used in calculations; the B registers 
are used for incrementing and indexing. 

Relocation - 

Placement of object code into central memory in locations that are not predetermined, and adjusting 
the addresses accordingly. 

Remote Assembly - 

An operation in which code is assembled, saved, and then inserted into the object code when specified. 
Strong External - 

An external reference whose satisfaction is obligatory for program loading. 
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Subprogram 

A group of COMPASS statements beginning with an IDENT pseudo instruction and ending with an END 
pseudo instruction. 

Symbol - 

A set of characters that identifies a value and its associated attributes. 

Symbolic Instruction - 

An assembler-defined instruction appearing in the operation field of a statement- It provides a means 
of expressing symbolically the data manipulation functions of the machine. Each symbolic instruction 
typically generates one machine instruction. 

System Text - 

A set of tables containing symbol, micro, macro, and opdef definitions that can be saved on a file to be 
accessed by other programs. 

Transfer Address - 

The address of the entry point to which the loader jumps to begin program execution. 

Variable Field- 

The field in a COMPASS statement identifying operands for the statement. It consists of one or more 
subfields, and begins with the first nonblank character after the operation field. 

Weak External - 

An external reference that is ignored by the loader during library searching and cannot cause any other 
program to be loaded. A weak external is linked, however, if the corresponding entry point is loaded 
for any other reason. 

Zero Block - 

The nominal central memory block for a relocatable assembly. It is local to a sub-program. Also, a 
zero block is created for an absolute assembly if default symbols are used. 
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INDEX 


A abort mode 10'-2 
A code option 4-27 
A error 11-9 
A list option 4-74 
A reference table option 4-80 
A register 

I Description 8-7, 9-22 
Designators 2-8 
Setting 8-44 

Used for CM relocation 9-2 
ABS attribute 4-66 
ABS pseudo 

Description 4-6 

Example 4-4, 4-7, 4-13, 4-14, 4-16, 4-17 
First statement group 4-2 
Absolute block 

Absolute program 3-6 
Description 3-2 
Establishment 4-32 
Relocatable program 3-5 
Using 4-32, 4-33 
I Absolute CPU Program 4-6 
Absolute program 
Declaration 4-6 
Structure 3-6 
Absolute text 3-5 
ACN instruction 9-24 
ADC instruction 

Arithmetic function 9-6 
Description 9-11 
Example 2-20, 9-11 
ADD instruction 

Arithmetic function 9-6 
Description 9-15 
Add unit 

Floating point 8-3, 8-6 
Long 8-3 
Address 

Absolute 4-4 
Direct 9-15 

Entry point 4-4, 4-5, 4-45 
External 4-6, 4-9, 4-47 
Indexed direct 9-16 
Indirect 9-15 
Address modes, PP 9-1 
ADI instruction 

Arithmetic function 9-6 
Description 9-15 
ADM instruction 

Arithmetic function 9-6 
Description 9-16 
ADN instruction 

Arithmetic function 9-6 
Description 9-10 
AIDTEXT 8-1, 9-1, 11-11 
AJM instruction 9-19 
AOD instruction 

Description 9-15 
Replace function 9-7 
AOI instruction 

Description 9-15 
Replace function 9-7 
AOM instruction 

Description 9-16 
Replace function 9-7 
Arithmetic functions, PP 9-6 
Arithmetic shift 8-33 


Arrow 

Parameter separator 5-8,5-13 
Special character 2-4 
ASCII code 

Character set A-1 
Option 4-27 
Assembler 1-1 

Central memory requirements 1-3, 10-1 
Statistics 4-73, 11-8 
Assembly environment test 4-60 
Assembly listing 

Detailed description 11-1 
General description 4-73 
Generation 1-3 
Assembly, remote code 5-3 
Assembly time 11-8 
Asterisk 

BASE instruction 4-25 
Element operator 2-22 
First column 2-1, 2-2 
Local symbol separator 5-31 
Location counter 2-9, 3-4 
Parameter separator 5-8, 5-13, 5-16, 5-24, 5-28 
Special element 2-9, 2-32, 3-4 
USE instruction 4-32 
USELCiVl instruction 4-34 
Attribute, symbol 2-5 
Attribute test 4-66 
AXi instruction 8-32, 8-34 


B base 2-17, 2-18, 4-22 
B binary mode 10-2 
B list option 4-74 
B reference table option 4-80 
B register 

Conditional jumps 8-26 
Contents of 4-30 
Description 8-7 
Designators 2-8 
Setting 8-46 
Base, assembly 4-23 

COL column count 4-31 
DIS word count 4-49 
DUP count 5-6 
ECHO count 5-7 

Line count 4-60, 4-61, 4-63, 4-64, 4-67, 
4-69, 4-70 

Micro count 7-2, 7-4 
Numeric value 2-16 
Overlay level numbers 4-4 
PP number 4-4 
REP counts 4-57 
Setting tlirough BASE 4-24 
SPACE line count 4-76 
String count 2-13 
VFD count 4-53 
BASE micro 7-6 
BASE pseudo 

Description 4-24 

Example 4-13, 4-19, 4-26, 4-49, 4-51 
Permissible anywhere 4-2 
Binary card formats C-1 
Binary Control 4-6 

Binary control statements 4-1, 4-74, 11-1 
Binary load module 3-8 
Binary mode 10-2 
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Binary output generation 1-3, 3-7, 3-9, 3-11, 

3- 13, 10-2 

Binary write 3-8 
Blank 

Compressed 5-1 
Embedded 2-1 
Expression terminator 2-1 
Name terminator 2-5 
Operation field 2-1, 4-48 
Parameter separator 5-8,5-13 
Statement terminator 2-1 
String terminator 2-14 
Use in character data 2-14 
Variable field 2-2, 2-3, 3-8 
Blank card 4-76 
Blank common 
CM 4-32 
Description 3-3 
ECS 4-34 

Establishment 4-32, 4-34 
Example 4-38 
LCM 4-34 
SCM 4-32 
Blank fill 2-14 
DIS 4-49 

Blank operation field 4-47 
Block 

Absolute 3-1, 4-34, 4-38 
Blank common 3-3, 4-34, 4-36 
Input 9-22 

Labeled common 3-2, 4-32 
Literals 2-11, 3-2, 3-5 thru 3-15 
Local 3-2, 4-32 
Maximum number 3-1, 4-32 
Output 9-22 

Origin assigned 1-2, 3-5, 3-7 
Subprogram 3-1 

Used for definition operation 5-2 
User established 3-2, 4-32, 4-34 
Zero 3-2, 4-32, 4-34 
Block copy instruction 8-16 
Block group 3-1, 3-12, 3-14 
Block group listing 11-2 
Block name 3-3, 4-32, 4-34 
Block name listed 11-1 
Block origin 1-2, 3-5 
Block usage summary 11-2 
Boolean unit 

Description 8-3, 8-6 
Instructions 8-27 thru 8-31, 8-35, 8-36 
Branch instructions 

CPU 8-13, 8-14, 8-17, 8-23, 8-24, 8-26 
PP 9-7 
Branch unit 

Description 8-3 

Instructions 8-10, 8-14, 8-17, 8-23, 8-24, 8-26 
BSS Pseudo 

Description 4-37 

Effect on origin counter 3-3 

Example 4-4, 4-7, 4-10, 4-16, 4-30, 4-35, 

4- 38, 4-39, 4-42, 4-46, 

5- 22, 5-32 

Force upper 3-4 
BSSZ pseudo 

Description 4-48 
Dumped by SEGMENT 4-16 
Example 2-19, 5-33, 5-35 
Force upper 3-4 
BXi instruction 8-27 thru 8-31 
Byte, guaranteed zero 2-14, 4-50 
Bl=l or B7-1 pseudo instruction 
Description 4-30 
‘ Effect on R= 4-55 
Example 4-56 
lUegal for PP 4-9, 4-10 


C hardware feature code 4-8 
C list option 4-74 
C on octal listing 11-6 
Call 

Equivolenced macro 5-25 
Macro 5-18 
Opdef 5-29 
CC instruction 8-53 
CCF instruction 9-20 
Central read/write instructions 9-17, 9-19 
Central memory 

Head instruction 8-46 
Requirements 1-3, 10-1 
Write instruction 8-46 
Access instructions, PP 9-2 
Central processor unit 

Functional units 8-3, 8-6, 8-8 
Instructions 8-1 
Registers 8-7 
CFM instruction 9-20 
Channel buffer instruction 
Read status 8-22 
Reset input 8-21 
Reset output 8-22 
Channel flag instructions 9-20 
Channel function 9-24 
CHAR 

Define other character 4-26 
Character sets A-1 
Character data 2-13 

Code conversion 4-26 
Evaluation 2-27 
Examples 2-12, 2-15 
CIPPU 4-11 
CMU 8-50 
Code 

CPU operation 6-7, 8-1 
Duplication 5-6 
Code other 4-26 
PP operation 6-3, 9-1 
Remote assembly 5-3 
Replication 4-57 
CODE micro 7-6 
CODE pseudo 

Declare character data code 4-26 
Description 4-26 

Effect on character data 2-13, 4-49 
Example 4-27 
Permissible anywhere 4-2 
Coding form 2-3 
COL pseudo 

Description 4-9 
Octal listing 11-6 
Column one 2-1 
COM attribute 4-66 
Comma 

Character string 2-13 
Column one 2-1 
Continuation 2-1 
Expression terminator 2-21 
Local symbol separator 5-31 
Name terminator 2-5 

Parameter separator 5-8, 5-13, 5-lG, 5-24, 5-28 
String terminator 2-13 
Subfield delimiter 2-1 
COMMENT pseudo 
Description 4-20 
Example 4-13 
First statement group 4-2 
Comments column control 4-31 
Comments field 2-2, 2-3, 4-31 
Comments, prefix table 4-20 
Comments statement 2-2 

Heading of definition 5-13 
Micros not substituted 7-1 
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Comments statement (Contd) 


Not counted 

4-59, 5-’ 

Permissible anywhere 

Common common declcs 

COMCARG 

12-3 

COMCCDD 

12-4 

COMCCFD 

12-4 

COMCCIO 

12-5 

COMCCOD 

12-5 

COMCCPT 

12-6 

COMCDXB 

12-6 

COMCMNS 

12-7 

COMCMOS 

12-7 

COMCMTM 

12-8 

COMCMTP 

12-9 

COMCMVE 

12-13 

COMCRDC 

12-13 

COMCRDH 

12-14 

COMCRDO 

12-15 

COMCRDS 

12-16 

COMCRDW 

12-16 

COMCRSR 

12-17 

COMCSFN 

12-18 

COMCSRT 

12-18 

COMCSST 

12-18 

COMCSTF 

12-20 

COM CSV R 

12-20 

COMCSYS 

12-21 

COMCUPC 

12-22 

COMCWOD 

12-23 

COMCWTC 

12-23 

COMCWTH 

12-23 

COMCWTO 

12-24 

COMCWTS 

12-25 

COMCWTW 

12-25 

COMCXJR 

12-25 

COMCZTB 

12-25 


Compare character strings 4-68 
Compare expression values 4-62 
Compare/Move unit 8-50 
COMPASS control statement 
Description 10-2 
Effect on LIST 4-79 
Compile file 10-4 

Complement and logical difference instruction 8-31 
Complement and logical sum instruction 8-30 
Complement instruction 8-29 
Compressed code 5-1 
CON pseudo 

Description 4-54 

Example 2-22, 4-55, 5-5, 5-23, 5-26 
Force upper 3-4 
Concatenation 2-4 
Concatenation mark 2-4 
Example of use 5-19 
In definition 5-1 
Conditional assembly 4-59 
Conditional jump 
B register 8-26 
PP 9-7 

X register 8-24 
Configuration 1-3 
Constant 

Character 2-14 
Description 2-11 
Expression element 2-21, 2-26 
Field size 2-12 
Generated by pseudo 4-54 
I Mode instructions 9-11 
Numeric 2-1G 
Read only 2-11 
Continuation, statement 2-2 
Generation of lines 2-4, 7-1 
Control statements 
COMPASS 10-2 


Control statements (Contd) 

Job statement 10-1 
Counter control 
BSS 4-37 
Forcing upper 3-4 
LOG 4-38 
ORG 4-35 
ORGC 4-35 
POS 4-40 
USE 4-32 
USELCM 4-34 

Counters, block control 3-3, 3-10, 3-12 
CPOP pseudo 6-7 
CPSYN pseudo 

Description 6-10 
Permissible anywhere 4-2 
CPU instructions 

Block copy 8-16 

Boolean 8-27 thru 8-31, 8-35, 8-36 

Brandling 8-10, 8-14, 8-17, 8-23, 8-24, 8-26 

Channel buffer 8-21, 8-22 

Channel status 8-22 

Complement 8-29, 8-31 

Conditional 8-24, 8-26 

Direct LCM transfer 8-19 

Divide 8-42 

Double precision 8-38, 8-40 
ECS 8-15 
Error exit 8-14 
Exchange exit 8-18 
Exchange jump 8-17 
Fixed point 8-39 
Floating point 8-34 thru 8-40 
Increment 8-44, 8-46, 8-43 
Left shift 8-31, 8-32 
Logical 8-28 thru 8-32 
Long add 8-39 
Mask 8-42 

Multiply 8-39, 8-40, 8-41 
No operation 8-43 
Normalize 8-34 
Pack 8-36 
Pass 8-43 
Population 8-43 
Program stop 8-13 
Real-time clock 8-21 
Return jump 8-14 
Right shift 8-32, 8-33 
Set register 8-44, 8-46, 8-48 
Set time 8-21 
Shift 8-31 thru 8-33 

Single precision 8-37 thru 8-40, 8-42, 8-43 

Table 8-8 

Transmit 8-27 

Unconditional jump 8-23 

Unpack 8-35 

CPU program execution 1-3, 10-1 
CPU register designators 2-8, 8-11 
CPU symbolic machine instructions 8-1 
CRD instruction 9-17 
Created symbol 5-31, 11-8 
CRM instruction 9-18 
Cross reference table 

(see symbolic reference table) 

CTEXT pseudo 4-79 
CR Instruction 8-46 
CU Instruction 8-54 
CW Instruction 8-46 
CWD Instruction 9-18 
CWM Instruction 9-18 
CXi I ns trueti on 8-4 3 


D base 2-17, 4-24 
D code option 4-26 
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D debug mode 10-3 
D definition flag 11-14 
D error 11-10 

D hardware feature code 4-7 
D list option 4-74 
Data generation 4-47 
Data item 

Character format 2-13 
DATA pseudo 4-49 
General description 2-10 
LfT pseudo 4-51 
Numeric format 2-17 
VFD pseudo 4-53 
Data notation 

Character 2-13 
Constant 2-11, 2-13, 2-16 
Decimal 2-17 
Element 2-10, 2-21 
Fixed point 2-17 
Floatingpoint 2-17 
Hexadecimal 2-22 
Item 2-11, 2-13, 2-16 
Literal 2-12,2-13,2-16 
Numeric 2-17 
Octal 2-17 
DATA pseudo 

Description 4-48 
Example 2-15, 2-19, 2-20, 4-27, 4 
4-37, 4-49 

Force upper 3-4 
Data transmission, PP 9-6 
DATE micro 7-5 
Date of listing 11-1 
DayfEemessa ges E-1 
DCN instruction 9-24 
Debug, interactive 1-4 
Debug mode 10-3 
Decimal exponent 2-17 
Decimal notation 2-17 
DECtVIIC pseudo 

Description 7-4 
Example 5-6, 7-4 
Permissible anywhere 4-2 
DEF attribute 4-67 
Default symbols 
Definition 2-7 
Listing 11-9 
Unqualified 4-27 
Zero block 3-2 
Deferred symbols 

(see default symbols) 

Definition 

Equivalenced macro 5-24 
Macro 5-13, 5-15, 3-24 
Micro 7-2 
Opdef 5-13, 5-27 
Processing 5-13 
Purging 6-9 

Eeference 5-18, 5-25, 5-30 
Symbol 2-6, 4-44 
System 5-35 
Definition operation 

Duplicated code 5-6 
Eqiuvaienced macro 5-13 
Ejrternal text 5-2 
Macro 5-13 
Operation code 5-13 
Processing 5-14 
Recursion level 5-1 
Remote text 5-3 
I Delete header table 4-20 
Delimiter 

Actual parameter 5-18, 5-26 
Data item 2-15,2-16 


Delimiter (Contd) ' 

Expression element 2-21 
Field 2-1, 2-2 

Substitutable parameter 5-8, 5-13, 5-16 
Term 2-22 

Descriptor, variable field 5-27 
Destination field 2-26 
Detailed listing 4-74 
DF instruction 8-24 
Direct address mode 9-15 
Directives, loader 4-21 
Directory, error 11-9 
DIS pseudo 

Description 4-47 
Example 4-49, 4-51 
Force upper 3-4 
Display code option 

Character set A-1 
Default mode 2-13 
Option 4-27 

Divide instructions 8^2, 8-43 
DM instruction 8-52 
Dollar sign 

Local symbol separator 5-31 
Parameter separator 5-8, 5-13, 5-16, 5-24, 5-28 
Special element 2-5 
Double precision instructions 8-38, 8-40 
-33, DUP pseudo 

Description 5-B 
Example 5-10, 5-11 
Listing of count 11-6 
Duplication 
Code 5-6 
Eclioed 5-7 
Indefinite 5-7, 5-9 
DXi instructions 
Add 8-38 
Multiply 8-40 


E code option 4-27 
E entry point flag 11-14 
E error 11-10 
E list option 4-74 
E numeric data modifier 2-17 
ECHO pseudo 

Description 5-7 
Example 5-12 
ECS blocks 4-34 
Editing 2-4 

EE numeric data modifier 2-17 
EIM instruction 9-21 
EJECT pseudo 4-76 

Permissible anywhere 4-2 
Eject suppression 10-4 
EJM instruction 9-19 
Elem ent 

Absolute 2-24 
Data 2-11 

Expression 2-23, ^26 
External 2-26 
Operator 2-23 
Register 2-26 
Relocatable 2-9, 2-25 
Special 2-9, 2-23 
ELSE pseudo 

Description 4-60 
Example 5-5 
Perm issi bl e anyw Iler e 4-2 
END pseudo 

Assembly of remote code 5-3 
Binary generation 3-6 
Description 4-4 

Effect on blocks 3-1, 3-6, 3-8, 3-lU, 3-12 
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END pseudo (Contd) 

Example 4-4, 5-7, 5~13, 5-14, 5-16 
External text use 5-3 
Force upper 3-4 
Illegal definitions 5-1 
Permissible anywhere 4-2 
ENDD pseudo 

Acting as nil G-6 
Description 5-10 
Example 5-11 
Permissible anywhere 4-2 
Used with DUP 5-7 
Used with ECHO 5-8 
ENDIF pseudo 

Acting as nil 6-G 
Description 4-59 
Permissible anywhere 4-2 
ENDM pseudo 

Acting as nil 6-6 
Description 5-14 

Example 4-31, 5-11, 5-15, 5-19, 5-20, 5-21 
Permissible anywhere 4-2 
End-of-line mark 5-1 
ENDX pseudo 4-79 
Entry address 

Absolute 4-3 
Declaration 4-45 
Multiple 3-12 
Relocatable 4-4 
ENTRY pseudo 

Description 4-45 
Example 4-5, 4-46 
Entry point list 11-4 
ENTRYC pseudo 4-45 
Environment test 4-60 
EOM instruction 9-21 
EQ IF operator 4-62 
IFC operator 4-68 
EQ instruction 

Description 8-26 
Example 8-27 
Force upper 3-4 
EQU pseudo 

Description 4-41 

Example 2-19, 2-21, 4-19, 4-39, 4-41, 4-64, 5-6 
Listing 11-6 
Equal sign 

D ef a ul t s ym bol prefi X 2-7 
Instruction 4-41 
Literals prefix 2-11, 2-13, 2-17 
Local symbol separator 5-31 
Parameter separator 5-8, 5-13, 5-16, 5-25, 5-28 
ERN instruction 9-14 
ERR pseudo 

Description 4-71 
Error, assembly 
Fatal 11-9 
Informative 11-12 
Programmer controller 4-71, 4-72 
Error directory 

Detailed description 11-9 
General description 4-73 
Error exit instruction 8-14 
Error flags 

ConStionally set 4-71 
Fatal 11-9 
Informative 11-12 
Unconditionally set 4-72 
Where on listing 11-6 
ERRxx pseudo 4-72 
I Error stop 9-25 
ES instruction 8-14 
ESN instruction 9-25 
ETN instruction 9-14 
Evaluation of expression 2-26 


Exchange exit instruction 8-18 

Exchange jump instruction 8-13, 8-17, 9-12,1 

Execution, CPU program 1-3 

EXN instruction 9-12 

Exponent 2-17 

Expression 

Absolute 2-24 
Attribute 4-66 
Comparison 4-62 
CON use 4-54 
Description 2-23 
Evalua table 2-26 
Evaluation 2-21, 2-27, 3-3 
Examples 2-24, 2-55 
External 2-26 
Maximum size 2-27 
Operators 2-23 
Pass one value 2-27, 3-3 
Pass two value 2-27, 3-3 
Register 2-26, 8-9 
Relocatable 2-25 
Rules 2-22 
Size 2-26 
Types 2-24 

Value 2-23, 2-26, 3-3, 8-5 
VFD 4-53 
EXT attribute 4-66 
EXr pseudo 

Description 4-47 

Illegal in absolute code 4-6, 4-9, 4-10 
External BCD 

Character set A-1 
Option 4-27 
External symbol 

Declaration 4-47 
Description 2-5 
Strong 2-7 
Weak 2-7 

External symbol list 11-4 
External text 

Assembly 5-2 
File declaration 10-3 
Listing 4-79 


F conditional flag 11-14 
F error 11-10 
F FORTRAN mode 10-3 
F list option 4-74 
FAN instruction 9-24 
Fatal error flag 11-9 
Features of COMPASS 1-2 
Field 

Comments 2-2, 4-31 
Conventional 2-3 
Delimiter 2-1, 2-2 
Destination 2-25, 4-53 
Free 2-1 

Length, tlireshold 1-3 
Location 2-1 
Operation 2-1 
Size 2-1 
Subfield 2-2 
Terminator 2-1 
Variable 2-2 

File 

COMPUTE 10-3 
INPUT 10-3 
LGO 10-2 
List output 10-3 
Load and go 10-2 
OLDPL 10-5 
OPL 10-5 
OUTPUT 10-3 
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File (Contd) 

Source 10-3 

SYSTEXT 4-17, 10-3, 10-4, 10-5 
System text overlay 10-5 

FiU 

Blank 2-14 
Zero 2-14 

FIM instruction 9-21 

First column 2-1 

First statement group 4-2 

Fixed point data notation 2-17 

Fixed point instructions 8-39, 8-41 

FJM instruction 9-19 

Flag, error 

Listing 11-6 
Setting 4-71 
Type 11-14 

Floating point data notation 2-16 
I Floating point unit 8-3, 8-6, 8-6.1 
Add 8-37, 8-38 
Divide 8-43 
Multiply 8-39, 8-40 
FNC instruction 9-24 
FOM instruction 9-21 
Forcing upper 3-4 
BSS 4-37 

I Counter 3-4 

CPU instructions 8-2 
LOC 4-38 

Macro call 5-18, 5-25 
Opdef caU 5-27 
ORG 4-35 
ORGC 4-35 
4-55 

USE 4-32 
USELCM 4-34 
VFD 4-53 

Form, COMPASS coding 2-3 
Format 

Control statement lO-l 
CPU instruction 8-1 
Line 2-1 
Listing 11-1 
PP instruction 9-1 
FORTRAN 4-4, 10-3 
FulUist 10-3 

I Functional units 8-3, 8-6, 8-6.1, 8-6.2, 8-10 
Functions, PP 

Arithmetic 9-6 
Data transmission 9-6 
Logical 9-6 
Replace 9-7 
FXi instruction 
Add 8-37 
Divide 8-42 
Multiply 8-39 

G assembly mode 10-3 
G list option 4-74 
GE IF operator 4-62 
IFC operator 4-68 
GE instructions 8-26 
Generate binary segment 4-15 
Generate system text record 4-17 
Generate LDSET object directives 4-22 
Generate data words 4-48 
Generated code listing 4-74 
Generation, data 4-48 
Get text mode 10-3 
Glossary F-1 
GT IF operator 4-69 
IFC operator 4-74 
GT instruction 8-26 
Guaranteed zero 2-14, 4-50 


Hardware configuration 1-3 
Hardware feature dependency 4 -7 
Heading 

Information 11-1 
Listing 4-73, 11-1 
Macro 5-13 
Opdef 5-13 
Page 11-1 
HERE pseudo 

Description 5-4 
Permissible anywhere 4-2 
Hexadecimal data 2-22 

I code option 4-21 
I hardware feature code 4-8 
1 input mode 10 3 
1 NOLABEL option 4-21 
lAM instruction 9-22 
IAN instruction 9-22 
IBj instruction 8-22 
ID instruction 8-24 
IDENT pseudo 

Binary generation 3-8 thru 3-10 
Blank variable field 3-14, 4-11 
Description 4-2, 4-11 

Example 4-4, 4-7, 4-13, 4-14, 4-16, 4-17, 4-lb 
Force upper 3-4 
Identify 4-12 

Overlay generation 3-8, 3-9, 3-10, 4-12 
Progrutn identification 4-2 
Subprogram identification 4-2 
IF pseudo 4-65 
IF skipped lines listed 4-74 
IFC pseudo 

Description 4-68 
Example 5-5, 5-11 
Permissible anywhere 4-2 
IFCP pseudos 4-61 
IFOP pseudo 4-62 
IFPP pseudo 4-61 
IFtype pseudo 4-61 
IJM instruction 9-19 
IM instruction 8-51 

Increment unit 8-3, 8-6, 8-44, 8-46, 8-48 

Index register 8-7 

Indexed address, PP 9-16, 9-16.2 

Indirect address, PP 9-15 

Indirect address mode 9-16 

INPN 9-13 

Input, assembler 10-3 

Instructions 

Coding of 2-1 
CiVlU 8-50 
CPU 8-1 

Execution 8-2, 8-4 
Mnemonic ally identified 6-3 
Nil 6-6 

No-operution 8-43, 9-11 
PP 9-1 
Pseudo 4-1 

Redefinition 5-16, 5-25 
Synonymous 6-5, 6-10 
Syntactically identified 6-7 
Integer add 8-39 
Integer subtract 8-39 
Integer multiply 8-41 
Integer value 2-17 
Interactive debugging 1-4 
Internal BCD 

Character set D-1 
Option 4-27 
Interrupt Processor 9-13 
Invented symbol 5-32, 11-8 
I/O branch instructions 9-20.1 
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I I/O test and set channel flag 9-20.2 
I/O branch instructions 9-21 
IK instruction 8-24 
IRM instruction 9-21 
IRP pseudo 

Acting as nE 6-6 
Description 5-33 
Example 5-34, 5-35 
Permissible anywhere 4-2 
IXi instructions 8-39, 8-41 
J option 4-9, 4-10, 9-8 
JDATE micro 7-6 
Job statement 10-1 
JP instruction 

Description 8-23 
Force upper 3-5 

L control statement option 
Description 10-3 
Related to LIST 4-74 
L error 11-11 

L hardware feature code 4-8 
L list option 4-74 
L location flag 4-38, 11-14 
Labeled common 

Description 3-2 
Establishment 4-32, 4-34 
LCC pseudo 

I Description 4-21, 4-23 

lUegal if absolute 4-6, 4-9, 4-10 
LCM attribute 4-66 
LCM bloclG 3-2, 4-34 
LCM transfer instructions 8-16, 8-19 
I LCM/UEM 8-7 
LCN instruction 

Data transmission 9-6 
Description 9-10 
LDC instruction 

Data transmission 9-6 
Description 9-11 
Example 2-20 
LDD instruction 

Data transmission 9-6 
Description 9-15 
LDI instruction 

Data transmission 9-6 
Description 9-15 
LDM instruction 

Data transmission 9-6 
Description 9-16 
Example 5-21 
LDN instruction 

Data transmission 9-6 
Description 9-10 
Example 5-12, 9-10 
LDSET pseudo 
I Description 4-22 

Permissible anywhere 4-2 
LE IF operator 4-62 
IFC operator 4-68 
LE instruction 8-26 
Left shift instruction 8-31,8-32 
LGO control statement 10-6 
Library maintenance programs 2-1 
Linkage symbols 2-6,4-45 
List,fuU 10-3 
List, parameter 
ECHO 5-8 

Equivalenced macro 5-25 
Macro 5-18 
LIST pseudo 

Description 4-73 
Example 4-13, 5-6, 5-12 
Permissible anywhere 4-2 


List, short 10-4 
Listable output 

Assembled code 11-5 
Assembler statistics 11-8 
Binary control cards 11-1 
Block usage 11-2 
Control statement 10-3 
Default symbols 11-8 
Entry point symbols 11-4 
Error drectory 11-9 
Error flags 11-9 tliru 11-12 
External symbols 11-4 
Header information 11-1 
Literals 11-7 
Octal 11-5 

Source statements 11-5 
Statistics 11-8 
Subtitles 11-1 

Symbolic reference table 11-12 
TiUes 11-1 

User control 4-79, 10-3, 10-4 
Listing control 

Control statement 10-3,10-4 
Pseudo 4-73 
LIT pseudo 

Description 4-51 

Example 2-12, 2-17, 2-21, 4-15, 4-58, 5-6 
Listing 11-6, 11-7 
Literals 

Absolute program 3-6, 3-7, 3-10, 3-11 
Description of block 3-1, 3-2 
IDENT 3-10, 3-14 
Listing 11-7 
Location 1-3, 3-1, 3-2 
Notation 2-12 
Protection 4-35 
SEGMENT overlay 3-10 
SEG partial oinary 3-12 
Symbol (default) 2-7 
LJM instruction 

Description 9-6 
Example 5-21 
LMC instruction 

Description 9-11 
Logical function 9-6 
LMD instruction 

Description 9-15 
Logical function 9-6 
LMI instruction 

Description 9-15 
Logical function 9-6 
LMM instruction 

Description 9-16 
Logical function 9-6 
LMN instruction 

Description 9-10 
Logical function 9-6 
LO control statement option 10-4 
Load address 4-3 
Load and store 9-12 
Load-and-go file 1-3, 10-2 
Loader control statejnent 4-21 
Loader directive 4-21 
LOG attribute 4-66 
LOG pseudo 

Description 4-38 
Example 4-39, 4-55 
Location counter changed 3-4 
Local blocks 3-2 

Absolute program 3-6 
Description 3-2 
Establishment 4-32, 4-34 
Relocatable program 3-5 
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LOCAL statement 
Description 5-31 
Example 5-32 
Heading 5-13 
Local symbol 

Macro body 5-13 
Subprogram 3-1, 4-29 
Location counter 
BSS 4-37 
Control 4-38 
Description 3-4 
Forced upper 3-4 
I Position 3-4 
ORG 4-35 
ORGC 4-35 

Special element 2-9, 3-4 
USE 4-32 
USELCM 4-34 
Location field 
Listing 11-6 
Statement 2-1 
LO control card option 
Description 10-4 
Related to LIST 4-73 
Logical difference instruction 8-29 
Logical functions, PP 9-6 
Logical minus 2-22 

Logical product and complement ir^truction 8-30 
Logical product ire true ti on 8-28 
Logical shift instruction 8-31,8-32 
Logical sum ir^truction 8-28 
Long add unit 

I Description 8-3, 8-4, 8-6, 8-6.1 
Instructions 8-39 
LPC instruction 

Description 9-11 
Log!cd function 9-6 
LPN ir^truetion 

Description 9-10 
Logical function 9-6 
LRD instruction 9-12 
LT IF operator 4-62 
IFC operator 4-66 
LT instruction 8-2G 
LXi instruction 

Description 8-31, 8-32 
Example 2-19 


M base option 4-25 

M list option 4-74 

MACHINE pseudo 4-7 

Machine irstruction formats 8-1, 9-1, 9-2.1 

Machine model correspondence 8-8 

Machine test 4-60 

Macro 

Body 5-13 
Call 5-18,5-25 
Equivalenced 5-24 
Definition 5-13 
Header 5-14 
List control 4-74 
Name 2-2, 5-15, 5-18, 5-25, 6-1 
Permissible anywhere 4-2 
Processing 5-1, 5-14 
System defined 4-75, 5-35 
Terminator 5-14 
MACRO pseudo 

Description 5-15 

Example 4-31, 4-76, 5-5, 5-19 thru 5-22, 
5-32 thru 5-34 

IRP related 5-33 
Operation code table entry 6-1 
Permissible anywhere 4-2 


MACROE pseudo 

Description 5-24 
Example 5-26 
IRP related 5-33 
Operation code table entry 6-1 
Permissible anywliere 4-2 
MAN instruction 9-12 
Mask instruction 8-42 
Mass storage, system 1-3 
Master list control 4-73 
MAX pseudo 

Description 4-42 
Listing 11-6 
MD instruction 8-51 

MERISEL 4-21 | 

MESSAGE macro 12-25 
MI instruction 8-24, 8-26 
MIC attribute 4-67'" 

Mice NT pseudo 

Description 4-44 
Example 4-44 
Listing 11-6 

Permissible anywliere 4-2 
Micro 

Deci trial 7-4 

Definition 4-24, 4-27, 4-28, 7-2 
Editing 2-4 
Mark 2-4, 5-1 
Octal 7-4 

Predefined nam es 7-5 
Reference 7-1 
Size 4-44, 7-2 
Substitution 7-1 
System defined 4-17, 7-2, 7-5 
Teitfor. 4-67 
IVUCRO pseudo 

Description 7-2 
Example 4-44, 5-11, 7-2, 7-3 
Permissible anywhere 4-2 
MIN pseudo 

Description 4-43 
Listing 11-6 

Minus us local symbol separator 5-31 
Minus us parameter separator 5-8, 5-13, 5-16, 

5-24, 5-28 

Minus on listing 11-6 

Minus operator 2-21, 2-22, 8-li, 8-12 

Minus sign in location field 

CPU instruction 3-4, 3-5, 4-53 
PP instruction 3-4, 4-53 
VFD instruction 4-53 
MJ instruction 8-18 
Force upper 3-4 
MJN instruction 

Description 9-6 
Effect of J 4-9, 4-11 
ML control statement option lU-M 
Mnemonic operation code 

Legal operation field entry 2-1 
OPDEF defined 5-27 
Search for 6-1 
Modifiers, numeric data 2-17 
MODIFY common aecl<s 5-2 
-MODLEVEl micro 7-7 
MOVE macro 12-28 
Multiple entry point table 
Suppression 4-20 
Used for overlays 3-12 
MXi instruction 

Description 8-42 
Exam pie 2-19, 8-42 
MXN instruction 9-12 

N eject mode 10-4 
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N error 11-11 
N list option 4-75 
Nome 

Block 4-32, 4-34 
Different types 2-4 
Duplicate code 5-7, 5-8 
General description 2-4 
IF sequence 4-59 
Macro 5-16 

Micro 4-24, 4-27, 4-28, 7-2, 7-4, 7-5 
Mnemonic operation 6-1 
Overlay 4-11, 4-15 
Parameter 5-8 
Remote code 5-3 
NE IF operator 4-62 
IFC operator 4-68 
NE instruction 8-26 
Nesting, level of 1-3 
NG instruction 8-24, 8-26 
NIL pseudo 6-6 

Permissible anywhere 4-2 
NIM instruction 9-21 
NJN instruction 

Description 9-7 
Effect of J 4-9, 4-10 
NO eject option 10-4 
NO instruction 8-43 
I No operation instruction 9-11 
NOLABEL pseudo 

Description 4-20 
Permissible anywhere 4-2 
NOM instruction 9-21 
NO REF pseudo 4-78 

Permissible anywhere 4-2 
Normalize instruction 8-34 
Normalize unit 

I Description 8-6, 8-6.1, 8-6.2 
Instructions 8-34, 8-35 
Not equal sign 

Parameter separator 5-8,5-13 
Special character 2-4 
Numeric data 2-17 
NXi instruction 8-34 
NZ instruction 8-24, 8-26 

O base 2-18, 4-24 
0 error 

Description 11-11 
With AIDTEXT 8-1, 9-1 
O mode 10-4 
OAM instruction 9-22 
OAN instruction 9-22 
OBJ instruction 8-22 
Octal listing 11-5 
Octal notation 2-16 
OCT MIC pseudo 7-4 

Permissible anywhere 4-2 
OLDPL file 10-3 
Opdef 

Body 5-13 
CaU 5-29 
Definitipn 5-13 
Heading 5-13 
List control 4-72, 4-73 
Processing 5-14 
System defined 4-17, 4-33 
OPDEF pseudo 

Description 5-27 
Example 5-29 thru 5-32 
Operation code table entry 6-1 
Permissible anywhere 4-2 
O per and r e gis t er 8-7 
Operation code table 6-1 


Operation code value 
CPU 6-7, 8-1 
PP 6-3, 9-1 
Operation, definition 
Compressed 5-1 
Duplicated text 5-6 
External text 5-2 
General description 5-1 
Macro definition 5-13 
Opdef definition 5-13 
Remote text 5-3 
System 5-35 
Operation field 
Blank 4-48 
Description 2-1 
Search 6-1 
Operator 

Element 2-22 
Mnemonic 5-27, 6-3 
Register 2-21, 5-28, 6-7 
Terjn 2-22 

Operator with constant 2-13, 2-16 
OPL file 5-2, lU-3, 12-1 
OPSYN pseudo 

Description 6-5 
Permissible anywhere 4-2 
OR instruction B-24 
OHG pseudo 

Description 4-35 
Determine blocl<s 3-1 
Establish absolute blocks 3-2,4-35 
Example 4-4, 4-7, 4-13, 4-14, 4-16 
Location counter changed 4-35 
Origin counter changed 3-3, 4-35 
ORGC pseudo 4-35 
Origin 

Multiply entry point 4-3 
Overlay 4-12, 4-15 
Program 4-3 
Origin counter 
BSS 4-37 

Control 3-3, 4-35, 4-37 

Description 3-3 

Final value, absolute 3-6 

Final value, relocatable 3-5 

Forced upper 3-4 

ORG 4-35 

ORGC 4-35 

Special element 2-9, 3-3 
USE 4-32 

ORM instruction 9-21 
Overflow error 2-17 
Overlay 

Absolute 3-8 
Control tables 4-21 
Entry point 4-12, 4-15 
Generi description 3-6, 3-8 
Level numbers 4-4, 4-12, 4-15 
Multiple entry point 3-12 
Name 4-12, 4-15 
Origin 4-12, 4-15 
PP 3-7, 3-9 

Primary 3-8, 3-9, 3-11, 3-13, 4-12, 4-15 
Secondary 3-6, 3-8, 3-9, 4-12, 4-15 


P error 11-11 

P numeric data modifier 2-17 

P pagination mode 10-4 

Pack instruction 8-36 

Padding of CPU word 3-4, 4-53, 8-2 

Page heading 11-1 

Page number 11-1 
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Pa^ nation control 10-4 
Parameter 

Actual 5-7, 5-18, 5-25 
Embedded 5-18, ^25 
Formal 5-8, 5-13 
Indefinitely repeated 5-34 
Iterative 5-18, 5-25, 5-34 
Substitutable 5-8, 5-13, 5-16, 5-25, 5-28, 5-34 
Parameter mark 5-9, 5-13 
Parameter, null 5-9, 5-18, 5-25 
Parameter separator 
Actual 5-18, 5-25 
Formal 5-8, 5-13, 5-16 
Parcel 8-1 
Parentheses 

Local symbol separator 5-31 
Nested 5-9 

Parameter separator 5-8, 5-13, 5-16, 5-25, 5-28 
Partial binary 

IDENTtype 3-14 
SEG type 3-12 
Pass instruction 
CPU 8-43 
PP 9-9 
Pass one 

Expression evaluation 2-23, 2-26, 2-28, 3-3 
General description 1-3 
Maximum test 4-42 
Minimum test 4-43 
Symbol definition 2-6 
Pass two 

Expression evaluation 2-22, 2-26, 3-3 
General description 1-3 
Symbol definition 2-5 
Value for MAX 4-42 
Value for MIN 4-43 
PC control statement option 10-4 
PCOMMENT micro 7-7 
PD control statement option 10-4 
PEHIPH pseudo 

Description 4-10 
Effect on branch instructions 9-8 
Example 4-49, 6-5 
First statement g;roup 4-2 
PJN instruction 

Description 9-7 
Effect of J 4-9, 4-10 
PL instruction 8-24, 8-26 
Plus as local name separator 5-31 
Plus as parameter separator 5-8, 5-13, 5-16, 

5-25, 5-28 

Plus in location field 

CPU instruction 3-4 
PP instruction 3-5 
VFD instruction 4-53 
Plus on listing 11-6, D-2, D-3 
Plus operator 2-21, 2-23, 8-11 
Point 

Binary 2-18^ 2-19 
Decimal 2-18, 2-19 
Octal 2-18, 2-19 

Parameter separator 5-8, 5-13, 5-16, 5-25, 5-28 
Register designator 2-8 
Population unit 8-43 
POS pseudo 4-40 
Position counter 

Control 4-40,4-53 
Description 3-4 
Special element 2-9, 3-4 
Post radix 2-17 
PP instructions 9-1 

A-register I/O 9-22 
Block I/O 9-22 
Branch I/O 9-19,9-21 


PP instructions (Contd) 

Branch 9-7 

Central read/write 9-18 
Channel function 9-24 
Constant mode 9-11 
Designators 9-3 
Direct address 9-15 
Error stop 9-25 
Exchange jump 9-12 
Format 9-1 
Functions 9-6 
Indexed direct address 9-16 
Indirect address 9-15 
Machine model correspondence 9-4 
No address 9-10 
No operation 9-11 
Output record flag 9-23. 

Shift 9-9 

Symbolic machine 9-1 
PPOP 

Description 6-3 
Example 5-12, 6-5 
Permissible anywhere 4-2 
PPO pseudo 

Description 4-8 
Effect on branch 9-8 
Example 4-10, 4-54 
First statement group 4-2 
PPU memory size 4-21 
Prefix table 

Comments 4-20 
Generation 3-6 thru 3-8 
Suppression 4-21 
Preradix 2-17 
Program, absolute 3-6, 4-6 
Program example D-1 thru i>8 
Program execution 10-5 
Program identification 4-2 
Program origin 4-3 
Program, relocatable 3-5 
Program stop instruction 8-13 
Program structure 3-1 
PS control statement option 10-4 
PS instruction 

Description 8-13 
Force upper 3-4 
Pseudo instructions 

Binary control 4-6 
Block counter control 4-32 
Conditional assembly 4-59 
Data generation 4-47 
Definition operation 5-1 
Error control 4-71 
First statement group 4-2 
Introduction 4-1 
Listing control 4-73 
Micro 7-1 
Mode control 4-24 
Operation code table management 6-1 
Operation field entry 2-2 
Permissible anywhere 4-2 
Required 4-2 

Subprogram identification 4-2 
Subprogram linkage 4-45 
Symbol definition 4-40 
Types 4-1 
PSN instruction 9-11 
PURGDEF pseudo 

Description 6-10 
Permissible anywhere 4-2 
PURGMAC pseudo 
Description 6-7 
Example 6-6 
Permissible anywhere 4-2 


I 


I 
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Push down stack 1-3 
PXi instruction 8-36 


Q to represent expression 5-27, G-8 
QUAL micro 7-6 
QUAL pseudo 

Description 4-28 
Example 4-13, 4-3Q, 5-22 
Permissible anywhere 4-2 
Q uali fi er, s ym bol 4-28 

Used for definition operations 5-2 


R error 11-11 

R hardware feature code 4-8 
R list option 4-75 
R register 9-2, 9-3 
RAD instruction 

Description 9-15 
Replace function 9-7 
Radix 2-17 
RAI instruction 

Description 9-15 
Replace function 9-7 
RAM instruction 

Description 9-16 
Replace function 9-7 
RE instruction 

Description 8-15 
Force upper 3-4 

Read central memory instruction 8-46, 9-17 
I Read program address 9-13 
Real-time clock set instruction 8-21 
Record name, external text 5-3 
Recursion level 1-4, 5-1 
Recursion stack 1-4, 5-1 
Reference 

Macro 5-18 
Macroe 5-24 
Nested 5-1 
Opdef 5-27 

Reference table, symbolic 11-13 
Register designators 
CPOP 6-7 
Description 2-8, 8-7 
Not symbols 2-5 
OPDEF 5-27 
OPSYN 6-5 
PURGDEF 6-10 
Registers, CPU 2-8, 8-7 
REA DC macro 12-28 
READH macro 12-28 
RE ADO macro 12-29 
READS macro 12-29 
RE AD W macro 12-29 
RECALL macro 12-30 
REL attribute 4-66 
Relocatable program structure 3-5 
Relocatable test 4-66 
Relocation, CM access 9-2 
Relocation register 

Description 9-2, 9-3 
Load and store instructions 9-12 
Remote assembly 5-3 
REP pseudo 4-57 
REPC pseudo 4-57 
Repeat count 
DUP 5-7 
Replication 4-57 


REPI pseudo 

Example 4-57 
Description 4-57 
Illegal if absolute 4-6, 4-9, 4-10 
REPL table 

Result of BSSZ 4-48 
Result of REP, REPC, or REPI 4-57 
Written by SEGMENT 4-15 
Replace functions, PP 9-7 
Replication of code 4-57 
Reserve zeroed storage 4-48 
Return jump, CPU 8-14 
RFN instruction 9-23 
R1 instruction 8-21 
Right shift 8-32, 8-33 
RJ instruction 

Description 8-14 
Example 4-33, 5-21, 8-15 
Force upper 3-5 
RJM instruction 9-7 
RL instruction 8-16 
EMT pseudo 

Description 5-3 
Example 5-5, 5-6 
Permissible anywhere 4-2 
RO instruction 8-22 
Round and normalize instruction 8-35 
RPN instructions 9-13 
RXi instructions 
Add 8-38 
Divide 8-43 
Multiply 8-40 
RXj instruction 8-20 
R= pseudo 

Description 4-55 

Example 4-56, 5-21 

Illegal in PP program 4-9, 4-10 


S list option 4-75 
S numeric data modifier 2-18 
S storage flag 11-14 
S system text mode 10-5 
SAi instructions 

Description 8-44 

Example 2-15, 2-16, 2-19, 4-33, 4-38, 5-22, 
33,8-45 

SBD instruction 

Arithmetic function b-6 
Description 9-15 
SBI instruction 

Arithmetic function 9-6 
Description 9-15 
SBi instructions 

Description 8-46 
Example 2-9, 2-12, 8-47 
SBM instruction 

Arithmetic function 9-6 
Description 9-16 
SBN instruction 

Arithmetic function 9-6 
Description 9-10 
Scale, binary 2-18 
SCF instruction 9-20 
SCM blank common 3-3 
SCM labeled common 3-2 
SON instruction 

Description 9-10 
Logical function 9-6 
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SEG pseudo 

I Binary generation 3-12, 4-16 

Description 4-15 
Example 4-16 
Force upper 3-4 
Illegal in PP program 4-9, 4-10 
I Write partial binary 4-16 

SEGMENT pseudo 

Binary generation 3-8 thru 3-10, 3-12, 4-15 
Description 4-16 
Example 4-17 
Force upper 3-4 
Illegal in PP program 4-9, 4-10 
Overlay structure 3-10, 3-12 
Semicolon in definition 5-8, 5-13 
SEQUENCE micro 7-7 
Sequencing 

Listing 11-7 
Statement 2-1 
SET attribute 4-66 

I Set output record flag 9-24 
Set position counter 4-40 
Set register instructions 8-44 thru 8-49 
SET pseudo 

Description 4-41 
Example 2-9, 2-20, 5-11, 5-22 
Listing 11-6 
SFM instruction 9-20 
Shift 

Description of unit 8-3, 8-6 
CPU instructions 8-31 thru 8-33 
PP instruction 9-9 
SHN instruction 9-9 
Short jump limit 4-9, 4-11 
Short list 10-4 
Single precision instructions 
Add rounded 8-38 
Add unrounded 8-37 
Divide rounded 8-43 
Divide unrounded 8-42 
Multiply rounded 8-40 
Multiply unrounded 8-39 
SKIP pseudo 

Description 4-70 
Permissible anywhere 4-2 
Slant bar 

Local symbol separator 5-31 
Operator 2-22 

Parameter separator 5-8, 5-13, 5-16, 5-24, 5-28 
SOD instruction 

Description 9-15 
Replace function 9-7 
SOI instruction 

Description 9-15 
Replace function 9-7 
SOM instruction 

Description 9-16 
Replace function 9-7 
Space, embedded (see blank) 

SPACE pseudo 

Description 4-76 
Permissible anywhere 4-2 
Special elements 

FORTRAN call 2-9 
General description 2-9 
In variable field 2-2 
Location counter 3-4 
Origin counter 3-3 
Position counter 3-4 
SRD instruction 9-12 
SST attribute 4-67 


SST pseudo 4-45 
Example 4-13 
Permissible anywhere 4-2 
Stack, recursion 1-4, 5-1 
Statement 

Coding conventions 2-3 
Comments 2-2 
Compressed 5-1 
Continuation 2-2 
External source 5-2 
First column 2-1 
First group 4-1 
Format 2-1 
Listing 11-5 
Number assembled 11-8 
Size 2-1 

Source of 5-1, 10-3 
Statistics, assembler 11-8 
STD instruction 

Data transmission function 9-G 
Description 9-15 
STEXT pseudo 

Description 4-17 
Example 4-19 
First statement group 4-2 
STI instruction 

Data transmission function 9-6 
Description 9-13 
STM instruction 

Data transmission function 9-6 
Description 9-16 
STOPDUP pseudo 
Description 5-9 
Example 5-11 

Storage reservation 4-37, 4-48 
String, character 

Comparison 4-68 
Data generation 4-49 
Delimited 2-11, 2-14 
Empty 2-14 
Micro 2-4 
Notation 2-13 
Strong external 2-7 
Subprogram length 3-5 
Substitution, micro 7-1 
Subsubtitle 

CTEXT 4-79 
EJECT 4-76 
Listing of 11-1 
QUAL 4-28 
SPACE 4-76 
TITLE 4-77 
TTL 4-78 
Subtitle 

CTEXT 4-79 
Listing of 11-1 
TITLE 4-77 
SXi instruction 

Description 8-48 

Example 2-15, 2-19, 5-21, 5-31, 8-49 
Sym bol 

Attribute 2-6, 4-40, 4-66 
Created 5-32 
Default 2-7 
Definition 2-5, 4-40 
Duplicate 2-6 
Entry point 2-6 
External 2-7 
Invented 5-32, 11-8 
Literals 2-6 

Local to macro 5-13, 5-31 
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Symbol (Contd) 

Local to QUAL 3-1 
Location field 2-6 
Lost 11-8, 11-13 
Number defined 11-8 
Number referenced 11-8 
Previously defined 2-7 
QuaUfied 2-7, 4-27 
Redefinition 4-29, 4-41 
System-defined 2-6, 4-45 
Undefined 2-7 
Value 2-6, 4-39 
Symbol qualifier listed 11-1 
Symbol table 

Clearing 3-10, 3-12 
System text 4-17 

I Symbolic notation 8-1, 8-8, 9-1, 9 
Symbolic reference table 
Address reference 4-80 
Detailed description 11-12 
General description 4-73 
Generation 1-3 
List control 4-73, 10-3 
Omit symbol 4-78 
Synonymous operation 
CPU 6-10 
Mnemonic 6-5 
PP 6-5 
Syntactic 6-7 

Syntax definition 5-27, 6-7, 6-10 
Syntax search 6-1 
SYSTEM macro 12-30 
System text 4-19 
SYSTEXT option 10-4 

Related to G mode 10-4 
Related to STEXT 4-17 


T list option 4-73 
Table 

Operation code 6-1 
Symbolic reference 11-12 
USE 4-32 

TBj instruction 8-21 
Term 2-22 
Term operator 2-22 
T er mi nator, m aero 5-13 
Test symbol attribute 4-66 
Timelimit 10-1 
TIME micro 7-6 
Time of assembly 11-1 
TiUe 

ES 8-14 
IDENT 4-3 
Listing of 11-1 
PS 8-13 
TITLE 4-77 
TITLE pseudo 4-77 

Permissible anywhere 4-2 
Transfer symbol 4-4 
Transmit instruction 8-27 
Truncation, character data 2-13 
Expression value 2-26 
TTL pseudo 4-78 

Permissible anywhere 4-2 


U error 11-11 
UEM 

Block copy instructions 8-15 
Direct transfer instructions 8-20 
UJN instruction 

Effect of J 4-9, 4-10 
Description 9-7 
Unconditional jump 
CPU 8-23 
PP 9-7 

Underflow error 2-18 
Unpack instruction 8-35 
USE pseudo 

Change blocits 3-1 thru 3- 3, 3-5, 4-32 
Description 4-32 

Establish common bloclcs 3-2, 3-3, 4-32 
-2.2 Establish local bloclcs 3-2, 4-32 

Example 4-17, 4-30, 4-31, 4-33, 4-36, 4-38 
USE table 

Entry 4-32, 4-34, 4-35 
Reinitialization 3-10, 3-12, 4-11 
USELCM pseudo 

Description 4-34 

Establish common blocks 3-2, 3-3 

Example 4-35 

Illegal in PP program 4-9, 4-10 
USER control statement 10-7 
UXi instruction 8-35 


V error 11-11 
Value, numeric 2-17 
Variable field 2-2 
Variable field definition 4-53 
VFD pseudo 

Description 4-53 

Example 2-15, 4-25, 4-30, 4-33, 4-54, 5-22 

WE instruction 

Description 8-15 
Force upper 3-4 
Weak external 2-7 
WL instruction 8-16 
Write central memory instruction 8-46 
Write partial binary 4-16 
WRIT EC macro 12-31 
WRrrEH macro 12-31 
WRrrEO macro 12-31 
WRITES macro 12-32 
WRfrEW macro 12-32 
WXj instruction 8-20 


X external flag 4-47, 11-6 
X external text mode 10-5 
X file option 

Description 10-5 
XTEXT default 5-3 
X hardware feature code 4-8 
X list option 4-75 
X register 

Conditional instructions 8-24 
Description 8-7 
Designator 2-8 
Setting 8-48 
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XJ instruction 


I 


Description 8-17 
Force upper 3-4 
XREF pseudo 

Description 4-80 
Permissible anywhere 4-2 
XTEXT pseudo 5-2 

Related to CTEXT/ENDX 4-79 
XTEXT source 10-5 


Zero block 

Absolute program 3-2, 3-6, 3-7 
Description 3-2 
Relocatable program 3-5 


Zero fill 2-14, 4-53 
Zero guaranteed 

Data item 2-14 
DIS item 4-50 
Zeroed words 4-48 
ZJN instruction 

Description 9-8 
Effect of J 4-9, 4-10 
ZR instruction 

Description 8-24, 8-26 
Force upper 3-4 
ZXi Instruction 8-35 
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